Atualize uma tabela de recursos do site workspace para Unity Catalog

Esta página descreve como atualizar uma tabela de recursos existente em workspace para Unity Catalog.

Primeiro, o senhor deve atualizar a tabela subjacente workspace Delta . Siga estas instruções: Atualize as tabelas e a visualização para Unity Catalog.

Depois que a tabela e os dados subjacentes estiverem disponíveis em Unity Catalog, use upgrade_workspace_table para atualizar os metadados da tabela de recurso de workspace para Unity Catalog, conforme ilustrado no código a seguir. Databricks recomenda sempre usar a versão mais recente do databricks-feature-engineering para essas operações, independentemente da versão do Databricks Runtime que o senhor estiver usando.

Python
%pip install databricks-feature-engineering --upgrade

dbutils.library.restartPython()

from databricks.feature_engineering import UpgradeClient
upgrade_client = UpgradeClient()
upgrade_client.upgrade_workspace_table(
  source_workspace_table='recommender_system.customer_features',
  target_uc_table='ml.recommender_system.customer_features'
)

Os metadados a seguir são atualizados para o Unity Catalog:

Chave primária
Colunas da série temporal
Comentários de tabelas e colunas (descrições)
Tags de tabela e coluna
Notebook e linhagem de Jobs

Se a tabela de destino tiver comentários de tabela ou coluna existentes que sejam diferentes da tabela de origem, o método de atualização pulará a atualização dos comentários e logs um aviso. Se você estiver usando a versão 0.1.2 ou abaixo de databricks-feature-engineering, é gerado um erro e o upgrade não é executado. Para todos os outros metadados, uma incompatibilidade entre a tabela de destino e a tabela de origem causa um erro e impede a atualização. Para contornar o erro e substituir os metadados existentes na tabela de destino do Unity Catalog, passe overwrite = True para a API:

Python
upgrade_client.upgrade_workspace_table(
  source_workspace_table='recommender_system.customer_features',
  target_uc_table='ml.recommender_system.customer_features',
  overwrite=True
)

nota

Antes de chamar este API, o senhor deve primeiro atualizar a tabela subjacente workspace Delta para Unity Catalog.
A atualização de tags e colunas de séries temporais não é compatível com o site Databricks Runtime 13.2 ML e abaixo.
Lembre-se de notificar os produtores e consumidores sobre a tabela de recursos atualizada para começar a usar o novo nome da tabela em Unity Catalog. Se a tabela de destino no Unity Catalog tiver sido atualizada usando CREATE TABLE AS SELECT ou uma forma semelhante que clonou a tabela de origem, as atualizações da tabela de origem não serão sincronizadas automaticamente na tabela de destino.