Gerencie conexões no Partner Connect

Você pode executar tarefas administrativas com conexões do Databricks workspace para soluções de parceiros, como:

  • Gerenciamento de usuários de contas de parceiros.

  • Gerenciamento de entidade de serviço do Databricks e o access token pessoais relacionado ao Databricks que uma conexão usa.

  • Desconexão de um workspace de um parceiro.

Para administrar o Partner Connect, você deve entrar em seu workspace como administrador workspace . Para obter mais informações, consulte Gerenciar usuários.

Gerenciar usuários de contas de parceiros

Para parceiros que permitem que os usuários usem o Partner Connect para fazer login na conta ou site desse parceiro (como Fivetran e Rivery), quando alguém em sua organização se conecta a um parceiro de um de seus workspaces do Databricks pela primeira vez, essa pessoa se torna o administrador da conta do parceiro para esse parceiro em todos os workspaces da sua organização. Para permitir que outros usuários dentro de sua organização façam login naquele parceiro, o administrador da conta do parceiro em sua organização deve primeiro adicionar esses usuários à conta do parceiro de sua organização.Alguns parceiros também permitem que o administrador da conta de parceiro delegue essa permissão. Para obter mais informações, consulte a documentação no site do parceiro.

Se ninguém puder adicionar usuários à account de parceiros da sua organização (por exemplo, o administrador da sua account de parceiros não está mais disponível), entre em contato com os parceiros para obter assistência. Para obter links de suporte, consulte a lista de parceiros do Databricks Partner Connect.

Conectar dados gerenciados pelo Unity Catalog nas soluções de parceiros

Se o seu workspace estiver habilitado para o Unity Catalog, você pode conectar soluções de parceiros selecionadas aos dados gerenciados pelo Unity Catalog. Ao criar a conexão usando o Partner Connect, você pode escolher se os parceiros usam o Hive metastore (hive_metastore) ou outro catálogo de sua propriedade. Os administradores do Metastore podem selecionar qualquer catálogo no Metastore que esteja atribuído ao seu workspace.

Observação

Se a parceiros soluções não oferecer suporte ao Unity Catalog com Partner Connect, você poderá usar apenas o catálogo padrão do workspace . Se o catálogo padrão não for hive_metastore e você não for o proprietário do catálogo padrão, você receberá um erro.

Para obter uma lista de parceiros que dão suporte ao Unity Catalog com Partner Connect, consulte a lista de parceiros do Databricks Partner Connect .

Para obter informações sobre como solucionar problemas de conexão, consulte Solucionar problemas do Partner Connect.

Gerenciar entidades de serviço e tokens de acesso pessoal

Para parceiros que exigem princípios de serviço Databricks, quando alguém no seu espaço de trabalho Databricks se conecta a um parceiro específico pela primeira vez, o Partner Connect cria uma entidade de serviço do Databricks no workspace para uso com esse parceiro. Partner Connect gera nomes de exibição principais de serviço usando o formato <PARTNER-NAME>_USER. Por exemplo, para os parceiros Fivetran, o nome de exibição da entidade de serviço é FIVETRAN_USER.

O Partner Connect também cria um access tokenpessoal do Databricks e o associa a essa entidade de serviço do Databricks. O Partner Connect fornece o valor desses tokensaos parceiros nos bastidores para completar a conexão com esses parceiros. Você não pode view ou obter o valor deste tokens . Esses tokens não expiram até que você ou outra pessoa os exclua. Consulte também Desconectar-se de um parceiro.

Partner Connect concede as seguintes permissões de acesso à entidade de serviço Databricks em seu workspace:

Parceiros

Permissões

Fivetran, Matillion, Power BI, Tableau, erwin Data Modeler

Estas soluções não necessitam de entidade de serviço.

Hevo Data, Hunters, Rivery, RudderStack, Snowplow

  • A permissão de tokens CAN USE para criar um access token pessoal.

  • Permissão de criação SQL warehouse .

  • Acesso ao seu workspace.

  • Acesso ao Databricks SQL.

  • (Unity Catalog) O privilégio "USE CATALOG" no catálogo selecionado.

  • (Unity Catalog) O privilégio de`CREATE SCHEMA` no catálogo selecionado.

  • (Legacy Hive metastore) O privilégio USAGE no catálogo selecionado.

  • (Legado Hive metastore) O privilégio CREATE no catálogo hive_metastore para que o Partner Connect possa criar objetos no legado Hive metastore em seu nome.

  • Propriedade das tabelas que ele cria. A entidade de serviço não pode query nenhuma tabela que não crie.

Prophecy

  • A permissão de tokens CAN USE para criar um access token pessoal.

  • Acesse seu workspace.

  • permissão de criação clusters . A entidade de serviço não pode acessar nenhum clusters que não crie.

  • Permissão de criação Job . A entidade de serviço não pode acessar nenhum Job que não crie.

John Snow Labs, Labelbox

  • A permissão de tokens CAN USE para criar um access token pessoal.

  • Acesso ao seu workspace.

Alation, Anomalo, AtScale, Census, clouds dbt, Hex, Hightouch, Lightup, Monte Carlo, Preset, Privacera, Qlik Sense, Sigma, Stardog, ThoughtSpot

  • A permissão de tokens CAN USE para criar um access token pessoal.

  • O privilégio CAN USE no armazém Databricks SQL selecionado.

  • O privilégio SELECT nos esquemas selecionados.

  • (Unity Catalog) O privilégio "USE CATALOG" no catálogo selecionado.

  • (Unity Catalog) O privilégio USE SCHEMA no esquema selecionado.

  • (Legacy Hive metastore) O privilégio USAGE no esquema selecionado.

  • (Legacy Hive metastore) O privilégio READ METADATA para os esquemas selecionados.

Dados

  • A permissão de tokens CAN USE para criar um access token pessoal.

  • Permissão de criação SQL warehouse .

  • (Unity Catalog) O privilégio "USE CATALOG" no catálogo selecionado.

  • (Unity Catalog) O privilégio USE SCHEMA nos esquemas selecionados.

  • (Unity Catalog) O privilégio de`CREATE SCHEMA` no catálogo selecionado.

  • (Legacy Hive metastore) O privilégio USAGE no catálogo hive_metastore e nos esquemas selecionados.

  • (Legado Hive metastore) O privilégio CREATE no catálogo hive_metastore para que o Partner Connect possa criar objetos no legado Hive metastore em seu nome.

  • (Legacy Hive metastore) O privilégio SELECT nos esquemas selecionados.

Você pode precisar gerar um novo token de acesso pessoal do Databricks se o token existente tiver sido comprometido, perdido ou excluído, ou se sua organização tiver uma política periódica de rotação de tokens.Para gerar um novo token, use a API REST Databricks:

  1. Obtenha o ID do aplicativo da entidade de serviço do Databricks chamando a operação GET /preview/scim/v2/ServicePrincipals na API Workspace Service Principals do seu workspace. Anote o applicationId da entidade de serviço na resposta.

  2. Use o applicationId da entidade de serviço para chamar as POST /token-management/on-behalf-of/tokens operações na API REST de gerenciamento tokens do Databricks para seu espaço de trabalho.

  3. Anote o token_value na resposta e guarde em um local seguro, pois não há outra maneira de acessá-lo novamente se você precisar recuperá-lo.

Por exemplo, para obter a lista de nomes de entidade de serviço do serviço Databricks e IDs de aplicativos disponíveis para um workspace, você pode chamar curl da seguinte forma:

curl --netrc --request GET \
https://<databricks-instance>/api/2.0/preview/scim/v2/ServicePrincipals \
| jq '[ .Resources[] | { displayName: .displayName, applicationId: .applicationId } ]'

Substitua <databricks-instance> pelo nome da instância do espaço de trabalho do Databricks, por exemplo dbc-a1b2345c-d6e7.cloud.databricks.com para o espaço de trabalho onde existe a entidade de serviço.

O valor de ID do aplicativo da entidade de serviço está no campo applicationId da resposta, por exemplo, 123456a7-8901-2b3c-45de-f678a901b2c.

Para criar o novo valor do token para a entidade de serviço, você pode chamar da curl seguinte forma:

curl --netrc --request POST \
https://<databricks-instance>/api/2.0/token-management/on-behalf-of/tokens \
--data @create-token.json \
| jq '[ . | { token_value: .token_value } ]'

create-token.json:

{
  "application_id": "<application-id>",
  "comment": "Partner Connect",
  "lifetime_seconds": 1209600
}

Substituir:

  • <databricks-instance> com o nome da instância do espaço de trabalho, por exemplo dbc-a1b2345c-d6e7.cloud.databricks.com para o espaço de trabalho onde existe a entidade de serviço.

  • <application-id> com o valor do ID do aplicativo do responsável pelo serviço.

  • 1209600 com o número de segundos até que esse token expire. Por exemplo, 1209600 é o número de segundos em 14 dias.

O valor do novo token está no campo token_value da resposta, por exemplo, dapi12345678901234567890123456789012. Anote o valor do novo token na resposta e armazene em um local seguro, pois não há outra maneira de acessá-lo novamente se você precisar recuperá-lo.

Os exemplos anteriores usam um .netrc arquivo e jq. Observe que, nesse caso, o arquivo .netrc usa o valor do seu access tokenpessoal, e não aquele da entidade de serviço.

Depois de criar o novo token, você deve atualizar sua conta de parceiro com o valor do novo token. Para fazer isso, consulte a documentação no site do parceiro. Para obter links de documentação, consulte o guia de conexão do parceiro apropriado.

Para excluir um token existente:

Aviso

A exclusão de um token de acesso pessoal existente do Databricks é permanente e não pode ser desfeita.

  1. Obtenha a lista de tokens existentes chamando as GET /token-management/tokens GET operações na API REST do Databricks Token Management para seu espaço de trabalho.

  2. Na resposta, anote o token_id valor do token que você deseja excluir.

  3. Use esse valor de token_id para excluir o token chamando a operação DELETE /token-management/tokens/{token_id} na API REST do Gerenciamento de Token do Databricks para seu workspace.

Desconectar-se de um parceiro

Se o bloco de um parceiro tiver um ícone de marca de seleção, isso significa que alguém em seu workspace do Databricks já criou uma conexão com esse parceiro. Para se desconectar desse parceiro, Reset o bloco desse parceiro em Partner Connect. Reset o bloco de um parceiro faz o seguinte:

  • Remove o ícone de marca de seleção do parceiro no bloco.

  • Exclui o SQL warehouse ou cluster associado se o parceiro precisar de um.

  • Exclui a entidade de serviço Databricks associada, se os parceiros exigirem uma. A exclusão de uma entidade de serviço também exclui os access tokens pessoal Databricks relacionados a essa entidade de serviço. O valor desses tokensé o que completa a conexão entre seu workspace e os parceiros. Para mais informações, consulte gerenciar entidade de serviço e access tokenpessoal.

Aviso

A exclusão de um SQL warehouse, um cluster, uma entidade de serviço do Databricks ou o access token pessoal de uma entidade de serviço Databricks é permanente e não pode ser desfeita.

Redefinir o bloco de um parceiro não exclui a conta de parceiro relacionada à sua organização nem altera as configurações de conexão relacionadas com o parceiro.No entanto, a redefinição do bloco de um parceiro interrompe a conexão entre o espaço de trabalho e a conta de parceiro relacionada. Para se reconectar, você deve criar uma nova conexão do workspace para o parceiro e, em seguida, editar manualmente as configurações de conexão originais na conta de parceiro relacionada para corresponder às novas configurações de conexão.

Para redefinir o bloco de um parceiro, clique no bloco, clique em Delete Connection(Excluir conexão) e siga as instruções na tela.

Como alternativa, você pode desconectar manualmente um workspace Databricks de um parceiro excluindo a entidade de serviço Databricks relacionada em seu workspace associado a esses parceiros. Você pode querer fazer isso se quiser desconectar seu workspace de um parceiro, mas ainda manter outros recursos associados e ainda manter o ícone de marca de seleção exibido no bloco. A exclusão de uma entidade de serviço também exclui os access tokens pessoal relacionados a essa entidade de serviço. O valor desses tokensé o que completa a conexão entre seu workspace e os parceiros. Para mais informações, consulte gerenciar entidade de serviço e access tokenpessoal.

Para excluir uma entidade de serviço do Databricks, você utiliza a API REST Databricks da seguinte maneira:

  1. Obtenha o ID do aplicativo da entidade de serviço do Databricks chamando a operação GET /preview/scim/v2/ServicePrincipals na API Workspace Service Principals do seu workspace. Anote o applicationId da entidade de serviço na resposta.

  2. Use os diretores de serviço applicationId para chamar a DELETE /preview/scim/v2/ServicePrincipals operação na API Workspace Service Principals do seu workspace.

Por exemplo, para obter a lista de nomes de exibição das entidades de serviço disponíveis e IDs de aplicativo para um workspace, você pode chamar o curl da seguinte maneira:

curl --netrc --request GET \
https://<databricks-instance>/api/2.0/preview/scim/v2/ServicePrincipals \
| jq '[ .Resources[] | { displayName: .displayName, applicationId: .applicationId } ]'

Substitua <databricks-instance> pelo nome da instância do espaço de trabalho do Databricks, por exemplo dbc-a1b2345c-d6e7.cloud.databricks.com para seu espaço de trabalho.

O nome de exibição da entidade de serviço está no campo displayName da saída. Partner Connect gera nomes de exibição de entidades de serviço usando o formato <PARTNER-NAME>_USER. Por exemplo, para os parceiros Fivetran, o nome de exibição da entidade de serviço é FIVETRAN_USER.

O valor da ID do aplicativo da entidade de serviço está no campo applicationId da saída, por exemplo, 123456a7-8901-2b3c-45de-f678a901b2c.

Para excluir a entidade de serviço, você pode chamar curl da seguinte maneira:

curl --netrc --request DELETE \
https://<databricks-instance>/api/2.0/preview/scim/v2/ServicePrincipals/<application-id>

Substituir:

  • <databricks-instance> com o nome da instância do espaço de trabalho, por exemplo dbc-a1b2345c-d6e7.cloud.databricks.com para seu espaço de trabalho.

  • <application-id> com o valor do ID do aplicativo do responsável pelo serviço.

Os exemplos anteriores usam um .netrc arquivo e jq. Observe que, nesse caso, o arquivo .netrc usa o valor do seu access tokenpessoal, e não aquele da entidade de serviço.

Depois de desconectar o site workspace de um parceiro, o senhor pode querer limpar qualquer recurso relacionado que o parceiro tenha criado no site workspace. Isso pode incluir um SQL warehouse ou clusters e quaisquer locais de armazenamento de dados relacionados. Para obter mais informações, consulte Criar um SQL warehouse ou Excluir um computador.

Se você tem certeza de que não existem outros espaços de trabalho em toda a sua organização conectados a esse parceiro, talvez você também queira excluir a conta da sua organização com esse parceiro.Para fazer isso, entre em contato com o parceiro para obter assistência. Para obter links de suporte, consulte o guia de conexão de parceiros apropriado.