Partilhar via


Solucionar problemas do Partner Connect

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

Solucionar erros gerais

Você pode ver os seguintes erros gerais ao tentar se conectar usando o Partner Connect.

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

Problema: quando você tenta conectar seu espaço de trabalho do 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árias razões pelas quais esse problema pode ocorrer:

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

Soluções:

Execute um dos seguintes procedimentos:

  • Peça ao primeiro indivíduo que criou a conta organizacional com o parceiro para adicionar seu endereço de e-mail a essa conta. Em seguida, ignore o Partner Connect e inicie sessão diretamente na conta de parceiro para começar a utilizar a solução do parceiro.
  • Tente estabelecer a ligação novamente através do Partner Connect mas, desta vez, especifique um endereço de e-mail que não esteja associado ao domínio da sua organização, como um endereço de e-mail pessoal. Isso pode exigir que você também adicione esse endereço de email como um usuário ao seu espaço de trabalho do Azure Databricks.
  • Ignore o Partner Connect e inicie sessão no parceiro diretamente com a sua conta existente e comece a utilizar a solução de parceiro.

Se o seu espaço de trabalho ainda não estiver conectado depois que você entrar no parceiro, conclua a conexão seguindo as instruções no guia de conexão de parceiro apropriado.

Ao tentar iniciar sessão na conta ou no Web site de um parceiro, é apresentado um bloqueador de pop-ups

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 de pop-ups é exibido. Este bloqueador de pop-ups impede-o de iniciar sessão na conta ou no Web site do parceiro.

Causa: O seu navegador está a bloquear pop-ups.

Solução: permita pop-ups para o site do parceiro no seu navegador da Web. As 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 na Internet com uma frase como "como faço para 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 de espaço de trabalho.

Solução: um administrador de conta ou um administrador de espaço de trabalho deve adicionar seu usuário ao grupo de administradores. Consulte Gerir grupos.

Permissões insuficientes para criar uma conexão de parceiro com dados gerenciados pelo Unity Catalog

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 possui o catálogo padrão do espaço de trabalho. Se uma solução de parceiro não estiver habilitada para o Catálogo 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ê possua explicitamente.

Solução: siga um destes 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 possui o catálogo padrão. Consulte Gerir grupos.

  • Peça a um administrador de 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 espaço de trabalho.
    • Substitua <metastore-id> pelo 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 assumem o catálogo padrão. Alterar o padrão faz com que essas operações não consigam localizar os objetos de dados aos quais fazem referência.

    Para obter mais informações, consulte Vincular um metastore a um espaço de trabalho.

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

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

Causa: se o espaço de trabalho estiver habilitado para Unity Catalog, esse problema pode ocorrer porque o catálogo padrão não hive_metastoreé . Se a solução de parceiro não suportar conexões com dados gerenciados pelo Unity Catalog usando o Partner Connect, isso interromperá sua conexão existente.

Solução: siga um destes procedimentos:

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

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

    • Substitua <workspace-id> pela ID do espaço de trabalho.
    • Substitua <metastore-id> pelo 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 assumem o catálogo padrão. Alterar o padrão faz com que essas operações não consigam localizar os objetos de dados aos quais fazem referência.

    Para obter mais informações, consulte Vincular um metastore a um espaço de trabalho.

Solucionar erros de segurança

As configurações de segurança mencionadas nesta seção podem fazer com que as integrações do Partner Connect falhem.

Listas de acesso de IP

Problema: o seguinte aviso aparece na caixa de diálogo Conectar a 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 de lista de acesso IP estiver habilitado em seu espaço de trabalho, talvez seja necessário adicionar a integração de parceiros à lista de permissões.

Solução: Para conhecer as etapas para adicionar integrações de parceiros à lista de permissões, consulte 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 IP, consulte Configurar listas de acesso IP para espaços de trabalho.

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

  • Você habilitou a conexão de link privado front-end para seu espaço de trabalho

  • Você encontrar o seguinte erro no Partner Connect

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

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

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

Tokens de acesso pessoal

Problema: quando você tenta 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 tokens estiver desabilitada em seu espaço de trabalho, você não poderá usar o Partner Connect para integrar com soluções de parceiros, a menos que use um token Microsoft Entra ID (anteriormente Azure Ative Directory) ou suas credenciais de conta do Microsoft Entra ID para autenticar com o Power BI ou o Tableau.

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