Solução de problemas comuns no Azure Data Share

  • Artigo

Este artigo explica como solucionar problemas comuns no Azure Data Share.

Convites do Azure Data Share

Em alguns casos, quando novos usuários selecionam Aceitar Convite em um convite por email, eles podem ver uma lista vazia de convites. O problema pode ter uma das seguintes causas:

  • O serviço do Azure Data Share não foi registrado como provedor de recursos das assinaturas do Azure no locatário do Azure. Esse problema ocorre quando seu locatário do Azure não tem nenhum recurso do Data Share.

    Quando você cria um recurso Azure Data Share, ele registra automaticamente o provedor de recursos na assinatura do Azure. É possível registrar manualmente o serviço do Data Share usando as estas a seguir. Para concluir essas etapas, você precisa da Função de colaborador para a assinatura do Azure.

    1. No portal do Azure, vá para Assinaturas.
    2. Selecione a assinatura que você deseja usar para criar o recurso Azure Data Share.
    3. Selecione Provedores de Recursos.
    4. Pesquise Microsoft.DataShare.
    5. Selecione Registrar.

  • O convite foi enviado para o alias de email, em vez do endereço de email de logon do Azure. Caso já tenha registrado o serviço do Azure Data Share ou criado um recurso de Data Share no locatário do Azure, mas ainda não vê o convite, seu alias de email pode estar listado como destinatário. Entre em contato com o provedor de dados e verifique se o convite será enviado para o endereço de email de logon do Azure, não para o alias de email.

  • O convite já foi aceito. O link no email leva você para a página Convites do Data Share no portal do Azure. Esta página lista apenas os convites pendentes. Os convites aceitos não aparecem na página. Para exibir os compartilhamentos recebidos e definir a configuração de cluster do Azure Data Explorer de destino, vá para o recurso Data Share que usou para aceitar o convite.

  • Você é um usuário convidado do locatário. Se você for um usuário convidado do locatário, será necessário verificar seu endereço de email do locatário para ver o convite. Depois de confirmado, ele será válido por 12 meses.

Criar e receber compartilhamentos

Os erros a seguir podem aparecer ao criar um novo compartilhamento, adicionar conjuntos de dados ou mapear conjuntos de dados:

  • Falha ao adicionar conjuntos de dados.
  • Falha ao mapear o conjuntos de dados.
  • Não é possível conceder ao recurso Data Share o acesso x para y.
  • Você não tem permissões adequadas para x.
  • Não foi possível adicionar permissões de gravação para a conta do Azure Data Share a um ou mais dos recursos selecionados.

Será possível ver um desses erros se não tiver permissões suficientes para o armazenamento de dados do Azure. Para obter mais informações, confira Funções e requisitos.

A permissão de gravação é necessária para compartilhar ou receber dados de um armazenamento de dados do Azure. Normalmente, essa permissão é parte da função de Colaborador.

Caso esteja compartilhando ou recebendo dados do armazenamento de dados do Azure pela primeira vez, a permissão Microsoft.Authorization/role assignments/write também será necessária. Normalmente, essa permissão é parte da função de Proprietário. Mesmo que tenha criado o recurso de armazenamento de dados do Azure, você não é, necessariamente, o proprietário do recurso.

Quando você tem as permissões apropriadas, o serviço Azure Data Share permite, automaticamente, que a identidade gerenciada do recurso de compartilhamento de dados acesse o armazenamento de dados. Esse processo pode levar alguns minutos. Caso experimente uma falha devido a esse atraso, tente novamente após alguns minutos.

O compartilhamento baseado em SQL requer permissões extras. Para obter informações sobre pré-requisitos, consulte Compartilhar a partir de fontes SQL.

Instantâneos

Um instantâneo pode falhar por vários motivos. Abra uma mensagem de erro detalhada selecionando a hora de início do instantâneo e, em seguida, o status de cada conjunto de dados.

Normalmente, os instantâneos falham por estes motivos:

  • O Data Share não tem permissão para ler do armazenamento de dados de origem ou gravar no armazenamento de dados de destino. Para obter mais informações, confira Funções e requisitos. Caso esteja capturando um instantâneo pela primeira vez, o recurso Data Share pode precisar de alguns minutos para obter acesso ao armazenamento de dados do Azure. Aguarde alguns minutos e tente novamente.
  • A conexão do Data Share ao armazenamento de dados de origem ou o armazenamento de dados de destino é bloqueada por um firewall.
  • Um conjunto de dados compartilhado, um armazenamento de dados de origem ou um armazenamento de dados de destino foi excluído.

Para contas de armazenamento, um instantâneo pode falhar porque um arquivo está sendo atualizado na origem enquanto o instantâneo está ocorrendo. Como resultado, um arquivo de 0 bytes pode aparecer no destino. Após a atualização na origem, os instantâneos devem ser bem-sucedidos.

Para fontes SQL, um instantâneo pode falhar por estes outros motivos:

  • O script SQL de origem ou o script SQL de destino que concede permissão ao Data Share não foi executado. Ou para o Banco de Dados SQL do Azure ou o Azure Synapse Analytics (anteriormente SQL Data Warehouse do Azure), o script é executado usando a autenticação SQL em vez da autenticação do Microsoft Entra. Você pode executar a consulta abaixo para verificar se a conta do Data Share tem permissão adequada para o banco de dados SQL. Para o banco de dados SQL de origem, o resultado da consulta deve mostrar que a conta do Data Share tem a função db_datareader. Para o banco de dados SQL de destino, o resultado da consulta deve mostrar que a conta do Data Share tem funções db_datareader, db_datawriter e db_dlladmin.

        SELECT DP1.name AS DatabaseRoleName,
    isnull (DP2.name, 'No members') AS DatabaseUserName
    FROM sys.database_role_members AS DRM
    RIGHT OUTER JOIN sys.database_principals AS DP1
    ON DRM.role_principal_id = DP1.principal_id
    LEFT OUTER JOIN sys.database_principals AS DP2
    ON DRM.member_principal_id = DP2.principal_id
    WHERE DP1.type = 'R'
    ORDER BY DP1.name;

  • O armazenamento de dados de origem ou o armazenamento de dados SQL de destino está em pausa.

  • O processo do instantâneo ou o armazenamento de dados de destino não dá suporte a tipos de dados SQL. Para obter mais informações, consulte Compartilhar de fontes SQL.

  • O armazenamento de dados de origem ou o armazenamento de dados SQL de destino está bloqueado por outros processos. O Azure Data Share não bloqueia esses armazenamentos de dados. Mas os bloqueios existentes nesses armazenamentos de dados podem fazer um instantâneo falhar.

  • A tabela SQL de destino é referenciada por uma restrição de chave estrangeira. Durante um instantâneo, se uma tabela de destino tiver o mesmo nome que uma tabela nos dados de origem, o Azure Data Share descartará a tabela e criará uma nova tabela. Se a tabela SQL de destino for referenciada por uma restrição de chave estrangeira, a tabela não poderá ser removida.

  • Um arquivo CSV de destino é gerado, mas os dados não podem ser lidos no Excel. É possível ver esse problema quando a tabela SQL de origem contiver dados que incluem caracteres que não sejam em inglês. No Excel, selecione a guia Obter dados e escolha o arquivo CSV. Selecione a origem do arquivo 65001: Unicode (UTF-8)e, em seguida, carregue os dados.

Atualizar agendamento de instantâneo

Depois que o provedor de dados atualizar o agendamento de instantâneos para o compartilhamento enviado, o consumidor de dados precisará desabilitar a agenda de instantâneos anterior. Em seguida, habilite o agendamento de instantâneo atualizado para o compartilhamento recebido. O agendamento do instantâneo é armazenado em UTC e mostrado na interface do usuário na hora local do computador. Ele não é ajustado automaticamente para o horário de verão.

Compartilhamento no local

O mapeamento do conjunto de dados pode falhar para clusters do Azure Data Explorer devido aos seguintes motivos:

  • O usuário não tem permissão de gravação no cluster do Azure Data Explorer. Normalmente, essa permissão é parte da função de Colaborador.
  • O cluster do Azure Data Explorer de origem ou destino está em pausa.
  • O cluster de origem do Azure Data Explorer é EngineV2 e o de destino é EngineV3 ou vice-versa. Não há suporte para compartilhamento entre clusters do Azure Data Explorer de diferentes versões de mecanismo.

Próximas etapas

Para saber como iniciar o compartilhamento de dados, continue com o tutorial sobre como Compartilhar dados.

Para saber como receber dados, continue até o tutorial sobre como Aceitar e receber dados.