gerenciar Delta Sharing provedores (para destinatários de dados)

Este artigo descreve como usar Unity Catalog para obter informações sobre os provedores de dados que estão compartilhando dados com o senhor usando Delta Sharing. Ele também descreve o que é um objeto de provedor e quando o senhor pode precisar criar um objeto de provedor no metastore do Unity Catalog, uma tarefa que a maioria dos destinatários nunca precisará fazer.

important

Os destinatários dos dados devem ter acesso a um site Databricks workspace que esteja habilitado para Unity Catalog para usar a funcionalidade descrita neste artigo. Este artigo não se aplica a destinatários que não tenham um espaço de trabalho habilitado para o Unity Catalog.

Os destinatários precisam criar objetos de provedor?

Em Delta Sharing em Databricks, o termo "provedor" pode significar tanto a organização que está compartilhando dados com o senhor quanto um objeto seguro no metastore Unity Catalog de um destinatário que representa essa organização. A existência desse objeto seguro no metastore Unity Catalog de um destinatário permite que os destinatários gerenciem o acesso de sua equipe ao uso compartilhado de dados Unity Catalog.

Como destinatário com acesso a um metastore do Unity Catalog, o senhor normalmente não precisa criar objetos de provedor. Isso ocorre porque os dados devem ser compartilhados com o senhor usando o compartilhamento Databricks-to-Databricks, e os objetos do provedor são criados automaticamente no metastore do Unity Catalog.

nota

Se estiver recebendo dados de um provedor que não esteja compartilhando de um Unity Catalog habilitado Databricks workspace, o senhor pode usar o Catalog Explorer para importar o arquivo de credenciais do provedor. Consulte:Databricks Leia os conectores de uso compartilhado de dados de compartilhamento aberto.

Antes de começar

Para gerenciar provedores em seu site Databricks workspace:

• Seu workspace deve estar habilitado para o Unity Catalog.
• Para view um provedor, o senhor deve ser um administrador de metastore ou um administrador de metastore deve conceder-lhe o privilégio USE PROVIDER.
• Para criar um provedor, você deve ser administrador da metastore ou um administrador da metastore deve conceder a você o privilégio CREATE PROVIDER.
• Para atualizar um provedor, você deve ser o proprietário do objeto do provedor e ter o privilégio CREATE PROVIDER. Para obter detalhes, consulte Atualizar um provedor (renomear, alterar proprietário, comentar).

Por esse motivo, se o seu workspace foi criado sem um administrador de metastore, um administrador do Databricks account deverá conceder a um usuário ou grupo a função de administrador de metastore antes que o senhor possa trabalhar com objetos de provedor no Databricks. Consulte Ativação automática do Unity Catalog e (Opcional) Atribuir a função de administrador do metastore.

ver fornecedores

Para view uma lista de provedores de dados disponíveis, o senhor pode usar o Catalog Explorer, o Databricks Unity Catalog CLI, ou o comando SHOW PROVIDERS SQL em um Databricks Notebook ou o editor de consultas Databricks SQL.

Permissões necessárias : O senhor deve ser um administrador do metastore ou ter o privilégio USE PROVIDER para view todos os provedores no metastore. Outros usuários têm acesso somente aos provedores que possuem.

Catalog Explorer

1. In your Databricks workspace, click Catalog.

2. At the top of the Catalog pane, click the gear icon and select Delta Sharing.

   Alternatively, from the Quick access page, click the Delta Sharing > button.

3. On the Shared with me tab, view all available providers.

SQL

Run the following command in a notebook or the Databricks SQL query editor. Optionally, replace <pattern> with a LIKE predicate.

SQL

SHOW PROVIDERS [LIKE <pattern>];

CLI

Run the following command using the Databricks CLI.

Bash

databricks providers list

visualizar detalhes do provedor

Para view detalhes sobre um provedor, o senhor pode usar o Catalog Explorer, o Databricks Unity Catalog CLI, ou o comando DESCRIBE PROVIDER SQL em um Databricks Notebook ou o editor de consultas Databricks SQL.

Permissões necessárias : administrador do Metastore, usuário com o privilégio USE PROVIDER ou proprietário do objeto do provedor.

Os detalhes incluem:

• Compartilhamentos compartilhados pelo provedor (veja os compartilhamentos que um provedor compartilhou com o senhor).
• O criador do provedor, o carimbo de data e hora de criação, os comentários e o tipo de autenticação (TOKEN ou DATABRICKS). TOKEN representa os provedores que compartilharam dados com o senhor usando o protocolo de compartilhamento aberto Delta Sharing. DATABRICKS representa os provedores que compartilharam dados com o senhor usando o protocolo de compartilhamento Databricks-to-Databricks.
• Se o provedor usar o compartilhamento Databricks-to-Databricks: a nuvem, a região e o ID do metastore do Unity Catalog do provedor.
• Se o provedor usar compartilhamento aberto: seu endpoint de perfil de destinatário, que é o local onde o servidor de compartilhamento Delta Sharing está hospedado.

Catalog Explorer

1. In your Databricks workspace, click Catalog.

2. At the top of the Catalog pane, click the gear icon and select Delta Sharing.

   Alternatively, from the Quick access page, click the Delta Sharing > button.

3. On the Shared with me tab, find and select the provider.

SQL

Run the following command in a notebook or the Databricks SQL query editor.

SQL

DESC PROVIDER <provider-name>;

CLI

Run the following command using the Databricks CLI.

Bash

databricks providers get <provider-name>

visualizar ações que um provedor compartilhou com o senhor

Para view os compartilhamentos que um provedor compartilhou com o senhor, é possível usar o Catalog Explorer, o Databricks Unity Catalog CLI, ou o comando SHOW SHARES IN PROVIDER SQL em um Databricks Notebook ou o editor de consultas Databricks SQL.

Permissões necessárias : administrador do Metastore, usuário com o privilégio USE PROVIDER ou proprietário do objeto do provedor.

Catalog Explorer

1. In your Databricks workspace, click Catalog.

2. At the top of the Catalog pane, click the gear icon and select Delta Sharing.

   Alternatively, from the Quick access page, click the Delta Sharing > button.

3. On the Shared with me tab, find and select the provider.

SQL

Run the following command in a notebook or the Databricks SQL query editor. Optionally, replace <pattern> with a LIKE predicate.

SQL

SHOW SHARES IN PROVIDER [LIKE <pattern>];

CLI

Run the following command using the Databricks CLI.

Bash

 databricks providers list-shares <provider-name>

Atualizar um provedor (renomear, alterar proprietário, comentar)

O senhor pode usar o Catalog Explorer, o Databricks Unity Catalog CLI, ou o comando ALTER PROVIDER SQL em um Databricks Notebook ou o editor de consultas Databricks SQL para modificar o objeto do provedor em seu Unity Catalog metastore:

• Renomeie o provedor para modificar a forma como os usuários veem o objeto do provedor em suas interfaces do Databricks.
• Altere o proprietário do objeto do provedor.
• Adicione ou modifique comentários.

Permissões necessárias : você deve ser o proprietário do objeto do provedor para atualizar o proprietário. Você precisa ser administrador da metastore (ou usuário com o privilégio CREATE_PROVIDER) e proprietário do provedor para atualizar o nome do provedor. Você precisa ser o proprietário para atualizar o comentário. O proprietário inicial é o administrador da metastore.

Catalog Explorer

1. In your Databricks workspace, click Catalog.

2. At the top of the Catalog pane, click the gear icon and select Delta Sharing.

   Alternatively, from the Quick access page, click the Delta Sharing > button.

3. On the Shared with me tab, find and select the provider.

4. On the details page, update the owner, comment, or provider name.

   To rename a provider, click the kebab menu and select Rename.

SQL

Run the following command in a notebook or the Databricks SQL query editor.

SQL

ALTER PROVIDER <provider-name> RENAME TO <new-provider-name>
OWNER TO <new-owner>
COMMENT "<comment>";

CLI

Run the following command using the Databricks CLI. Replace <provider-name> with the current provider name and <new-provider-name> with the new name.

Bash

databricks providers update <provider-name> /
--new-name <new-provider-name> /
--comment "<new comment>" /
--owner <new-owner-name>

Excluir um provedor

Para excluir um provedor, o senhor pode usar o Catalog Explorer, o Databricks Unity Catalog CLI, ou o comando DROP PROVIDER SQL em um Databricks Notebook ou o editor de consultas Databricks SQL. Você deve ser o proprietário do objeto do provedor para excluir o provedor.

Quando você exclui um provedor, você e os usuários da sua organização (o destinatário) não podem mais acessar os dados compartilhados pelo provedor.

Permissões necessárias : proprietário do objeto do provedor.

Catalog Explorer

1. In your Databricks workspace, click Catalog.

2. At the top of the Catalog pane, click the gear icon and select Delta Sharing.

   Alternatively, from the Quick access page, click the Delta Sharing > button.

3. On the Shared with me tab, find and select the provider.

4. Click the kebab menu and select Delete.

5. On the confirmation dialog, click Delete.

SQL

Run the following command in a notebook or the Databricks SQL query editor.

SQL

DROP PROVIDER [IF EXISTS] <provider-name>;

CLI

Run the following command using the Databricks CLI.

Bash

databricks providers delete <provider-name>

If the operation is successful, no results are returned.