Compartilhar via

Solucionar problemas do Partner Connect

  • Artigo

Esta seção fornece informações para ajudar a resolver problemas comuns com o Partner Connect.

Solucionar erros gerais

Ao tentar se conectar usando o Partner Connect, você poderá ver os erros gerais a seguir.

Ao tentar se conectar a um parceiro, uma mensagem de erro é exibida

Problema: quando você tenta conectar seu workspace Azure Databricks a uma solução de parceiro usando o Partner Connect, um erro é exibido e você não pode criar a conexão.

Causas:

Há vários motivos pelos quais esse problema pode ocorrer:

  • Se vários indivíduos em uma organização tentarem criar uma conta com um parceiro, somente o primeiro deles terá êxito. Isso porque o parceiro pode oferecer algumas contas apenas no nível organizacional, e o primeiro indivíduo que cria essa conta também estabelece a conta para a organização.
  • Se você já tiver uma conta com o parceiro, a conexão ainda poderá falhar. Isso porque o parceiro pode tentar criar uma conta duplicada por engano.

Soluções:

Realize um dos seguintes procedimentos:

  • Peça ao primeiro indivíduo que criou a conta organizacional com o parceiro para adicionar seu endereço de email a essa conta. Em seguida, ignore o Partner Connect e entre na conta do parceiro diretamente para começar a usar a solução do parceiro.
  • Tente fazer a conexão novamente por meio do Partner Connect, mas, desta vez, especifique um endereço de email que não está associado ao domínio da sua organização, como um endereço de email pessoal. Isso pode exigir que você também adicione esse endereço de email como um usuário ao seu workspace do Azure Databricks.
  • Ignore o Partner Connect e entre no parceiro diretamente com sua conta existente e comece a usar a solução de parceiro.

Se o workspace ainda não estiver conectado depois de entrar no parceiro, conclua a conexão seguindo as instruções no guia de conexão do parceiro apropriado.a guia.

Ao tentar entrar na conta ou site de um parceiro, um bloqueador pop-up é exibido

Problema: para uma solução de parceiro que usa o Partner Connect para entrar na conta ou site do parceiro, quando você clica em Entrar, o Partner Connect abre uma nova guia no navegador da Web e um bloqueador pop-up é exibido. Esse bloqueador pop-up impede que você entre na conta ou no site do parceiro.

Causa: seu navegador da Web está bloqueando pop-ups.

Solução: permita pop-ups para o site do parceiro em seu navegador da Web. Instruções específicas variam de acordo com o navegador da Web. Por exemplo, para o Google Chrome, consulte bloquear ou permitir pop-ups no Chrome no site de ajuda do Google Chrome. Para outros navegadores da Web, pesquise a Internet com uma frase como "como permitir pop-ups para um site específico?"

Permissões insuficientes para criar uma conexão de parceiro

Problema: quando você tenta criar a conexão de parceiro, um erro de permissões é exibido e você não pode criar a conexão.

Causa: esse problema pode ocorrer porque você não é um administrador do workspace.

Solução: um administrador de conta ou um administrador de workspace deve adicionar seu usuário ao grupo de administradores. Confira Gerenciar grupos.

Permissões insuficientes para criar uma conexão de parceiro com dados gerenciados pelo Catálogo do Unity

Problema: quando você tenta criar a conexão de parceiro, o seguinte erro de permissões ausentes é exibido e você não pode criar a conexão:

You do not have permission to grant <read|write> access to the workspace default catalog. To enable granting <read|write> access to the default catalog or other catalogs, contact an account admin

Causa: esse problema pode ocorrer porque você não tem o catálogo padrão do workspace. Se uma solução de parceiro não estiver habilitada para o Catálogo do Unity com o Partner Connect, você só poderá se conectar ao catálogo padrão, e o catálogo padrão deverá ser hive_metastore ou outro catálogo que você tenha explicitamente.

Solução: Faça um dos seguintes procedimentos:

  • Peça a um proprietário do catálogo padrão para criar a conexão.

  • Peça a um proprietário do catálogo padrão para adicioná-lo ao grupo que tem o catálogo padrão. Confira Gerenciar grupos.

  • Peça a um administrador da conta para alterar o catálogo padrão executando databricks metastores assign. No exemplo de comando a seguir, substitua esses espaços reservados:

    • Substitua <workspace-id> pela ID do workspace.
    • Substitua <metastore-id> pela ID do metastore.
    • Substitua <catalog-name> pelo nome do catálogo padrão.
    databricks metastores assign <workspace-id> <metastore-id> <catalog-name>

    Aviso

    Alterar o catálogo padrão pode interromper as operações de dados existentes que dependem dele. Em particular, as operações de dados que não especificam o catálogo pressupõem o catálogo padrão. Alterar o padrão faz com que essas operações não consigam localizar os objetos de dados que referenciam.

    Para obter mais informações sobre o comando databricks metastores, consulte Comandos de CLI do Databricks.

A conexão de parceiro existente não pode mais acessar dados do Azure Databricks

Problema: quando você entra em uma conta de parceiro existente que se conecta ao seu workspace usando o Partner Connect e o parceiro tenta acessar dados do Azure Databricks, um erro é exibido, informando que você não tem permissões para acessar o catálogo padrão do workspace.

Causa: se o workspace estiver habilitado para o Catálogo do Unity, esse problema poderá ocorrer porque o catálogo padrão não é hive_metastore. Se a solução de parceiro não der suporte a conexões com dados gerenciados pelo Catálogo do Unity usando o Partner Connect, isso interromperá sua conexão existente.

Solução: Faça um dos seguintes procedimentos:

  • Desconecte-se do parceiro e reconecte-se, especificando o catálogo padrão. Consulte Desconectar de um parceiro. Essa solução exige que você possua o catálogo padrão.

  • Peça a um administrador da conta para alterar o catálogo padrão para hive_metastore executando databricks metastores assign. No exemplo de comando a seguir, substitua esses espaços reservados:

    • Substitua <workspace-id> pela ID do workspace.
    • Substitua <metastore-id> pela ID do metastore.
    databricks metastores assign <workspace-id> <metastore-id> hive_metastore

    Aviso

    Alterar o catálogo padrão pode interromper as operações de dados existentes que dependem dele. Em particular, as operações de dados que não especificam o catálogo pressupõem o catálogo padrão. Alterar o padrão faz com que essas operações não consigam localizar os objetos de dados que referenciam.

    Para obter mais informações sobre o comando databricks metastores, consulte Comandos de CLI do Databricks.

Solucionar erros de segurança

As configurações de segurança mencionadas nesta seção podem causar a falha das integrações do Partner Connect.

Listas de acesso de IP

Problema: o seguinte aviso aparece na caixa de diálogo Conectar-se ao parceiro, e você não consegue criar uma conexão com um parceiro:

Partner Connect might not work because IP access list is enabled.

Causa: se o recurso da lista de acesso do IP estiver habilitado no seu workspace, talvez seja preciso adicionar a integração de parceiros à lista de permissões.

Solução: para saber as etapas para adicionar integrações de parceiros à lista de permissões, confira a documentação do parceiro ou entre em contato com a equipe de suporte do parceiro.

Para obter mais informações sobre listas de acesso de IP, confira Configurar listas de acesso IP para workspaces.

Siga a solução nesta seção para definir as configurações do Link Privado do Azure para habilitar as integrações de parceiros se:

  • Você habilitou a conexão de Link Privado de front-end para seu workspace

  • Você encontra o seguinte erro no Partner Connect

    Partner Connect might not work because front-end Private Link is enabled.

Solução: defina as configurações de Link Privado para habilitar integrações de parceiros. Para obter etapas para definir as configurações de Link Privado, consulte a documentação do parceiro ou entre em contato com a equipe de suporte do parceiro.

Para obter mais informações sobre o Link Privado do Azure, confira Habilitar conexões de back-end e front-end do Link Privado do Azure.

Tokens de acesso pessoal

Problema: ao tentar criar uma conexão, o seguinte erro de Permissões ausentes é exibido:

Partner Connect requires personal access tokens to be enabled.

Causa: se a autenticação baseada em token estiver desabilitada no seu workspace, você não poderá usar o Partner Connect para integrar-se a soluções de parceiros, a menos que use um token do Microsoft Entra ID ou suas credenciais de conta do Microsoft Entra ID para autenticação com o Power BI ou o Tableau.

Para obter mais informações sobre tokens de acesso pessoal, consulte Monitorar e revogar tokens de acesso pessoal.