Acesso externo às exibições

Important

O acesso externo às visualizações através do catálogo Iceberg REST está em Beta. O acesso às visualizações via a API REST do Unity está em disponibilidade geral.

Motores externos podem consultar visualizações do Catálogo Unity usando as seguintes APIs:

• API REST do Unity para visualizações sobre tabelas Delta Lake.
• Catálogo Iceberg REST para visualizações sobre tabelas compatíveis com Iceberg.

O motor externo executa o SQL da visualização e lê as tabelas subjacentes. O leitor deve ter acesso à visualização e a cada visualização ou tabela referenciada.

Requirements

• Ative o acesso externo a dados para a metastore. Consulte Ativar o acesso aos dados externos ao Catálogo do Unity.
• Conceda USE CATALOG e USE SCHEMA nos catálogos e esquemas pais, SELECT na view e em cada view ou tabela referenciada, e EXTERNAL USE SCHEMA nos esquemas que contêm essas tabelas.
• Autentique-se com um token de acesso pessoal do Azure Databricks ou um token OAuth.
• Use a view SQL compatível com o motor externo.

Consultar exibições do Apache Spark

Versões mínimas para os exemplos do Spark:

• Apache Spark 4.0.
• Para visualizações Delta: Unity Catalog Spark connector 0.6.0 e Delta Lake 4.3.0.
• Para views do Apache Iceberg: Apache Iceberg 1.10.0.

Use nomes de catálogo do Unity Catalog como nomes de catálogo do Spark, inclusive para catálogos referenciados pela exibição.

Exibições em tabelas Delta

Configure o Spark usando Acesse tabelas do Databricks a partir de clientes Delta, com as versões do Spark, do conector do Unity Catalog e do Delta Lake listadas acima.

Para consultar a visualização, substitua <catalog>, <schema>, e <view> pelos nomes do seu catálogo, esquema e visualização, então execute o seguinte SQL no Spark:

SELECT * FROM <catalog>.<schema>.<view>;

Vistas sobre as tabelas Iceberg

Configure o Spark usando Acesse tabelas do Azure Databricks de clientes Apache Iceberg, com as versões do Spark e do Iceberg listadas acima.

Para consultar a view, substitua <catalog>, <schema> e <view> pelos nomes do seu catálogo, esquema e view e, em seguida, execute o seguinte SQL no Spark:

SELECT * FROM <catalog>.<schema>.<view>;

Limitações

• Criar e alterar views a partir de computação externa não é suportado.
• O motor externo deve suportar definições de view no dialeto Spark SQL. Consultas que referenciam a visualização usam o dialeto SQL do motor externo.

Para acesso ao catálogo Iceberg REST:

• Visualizações com políticas de controle de acesso detalhadas, caminhos de resolução personalizados ou funções definidas pelo usuário não são suportadas.
• As versões de visualização histórica não são compatíveis.
• O Spark usa as configurações de SQL do leitor de dados. Resultados ou erros podem diferir do Databricks Runtime.