Solucionar problemas comuns no Compartilhamento de Dados do Azure

  • Artigo

Este artigo explica como solucionar problemas comuns no Compartilhamento de Dados do Azure.

Convites de Partilha de Dados do Azure

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

  • O serviço de Compartilhamento de Dados do Azure não está registrado como um provedor de recursos de qualquer assinatura do Azure no locatário do Azure. Esse problema acontece quando seu locatário do Azure não tem nenhum recurso de compartilhamento de dados.

    Quando cria um recurso do Azure Data Share, regista automaticamente o fornecedor de recursos na sua subscrição do Azure. Você pode registrar manualmente o serviço de Compartilhamento de Dados usando as etapas a seguir. Para concluir essas etapas, você precisa da função de Colaborador para a assinatura do Azure.

    1. No portal do Azure, aceda a Subscrições.
    2. Selecione a assinatura que você deseja usar para criar o recurso de Compartilhamento de Dados do Azure.
    3. Selecione Fornecedores de Recursos.
    4. Procure Microsoft.DataShare.
    5. Selecione Registar.

  • O convite é enviado para o seu alias de e-mail em vez do seu endereço de correio eletrónico de início de sessão do Azure. Se você já registrou o serviço de Compartilhamento de Dados do Azure ou criou um recurso de Compartilhamento de Dados no locatário do Azure, mas ainda não consegue ver o convite, seu alias de email pode estar listado como o destinatário. Entre em contato com seu provedor de dados e verifique se o convite será enviado para seu endereço de email de entrada do Azure e não para seu alias de email.

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

  • Você é usuário convidado do locatário. Se for um utilizador convidado do inquilino, terá de verificar o seu endereço de e-mail do inquilino antes de ver o convite. Uma vez verificado, é válido por 12 meses.

Criação e recebimento de compartilhamentos

Os seguintes erros podem aparecer quando você cria um novo compartilhamento, adiciona conjuntos de dados ou mapeia conjuntos de dados:

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

Você pode ver um desses erros se tiver permissões insuficientes para o repositório de dados do Azure. Para obter mais informações, veja Funções e requisitos.

Você precisa da permissão de gravação para compartilhar ou receber dados de um repositório de dados do Azure. Essa permissão normalmente faz parte da função de Colaborador.

Se você estiver compartilhando dados ou recebendo dados do armazenamento de dados do Azure pela primeira vez, também precisará da permissão Microsoft.Authorization/role assignments/write . Essa permissão normalmente faz parte da função Proprietário. Mesmo se você criou o recurso de armazenamento de dados do Azure, você não é necessariamente o proprietário do recurso.

Quando você tem as permissões adequadas, o serviço de Compartilhamento de Dados do Azure permite automaticamente que a identidade gerenciada do recurso de compartilhamento de dados acesse o armazenamento de dados. Este processo pode demorar alguns minutos. Se ocorrer uma falha devido a este 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 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.

Os snapshots geralmente falham pelos seguintes motivos:

  • O Compartilhamento de Dados não tem permissão para ler do armazenamento de dados de origem ou para gravar no armazenamento de dados de destino. Para obter mais informações, veja Funções e requisitos. Se você estiver tirando um instantâneo pela primeira vez, o recurso de Compartilhamento de Dados pode precisar de alguns minutos para obter acesso ao repositório de dados do Azure. Após alguns minutos, tente novamente.
  • A conexão de Compartilhamento de Dados com o armazenamento de dados de origem ou de destino é bloqueada por um firewall.
  • Um conjunto de dados compartilhado, armazenamento de dados de origem ou armazenamento de dados de destino foi excluído.

Para contas de armazenamento, um snapshot pode falhar porque um arquivo está sendo atualizado na origem enquanto o snapshot está acontecendo. 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 de Compartilhamento de Dados não foi executado. Ou para o Banco de Dados SQL do Azure ou o Azure Synapse Analytics (anteriormente Azure SQL Data Warehouse), o script é executado usando a autenticação SQL em vez da autenticação Microsoft Entra. Você pode executar a consulta abaixo para verificar se a conta de Compartilhamento de Dados 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 de Compartilhamento de Dados tem db_datareader função. Para o banco de dados SQL de destino, o resultado da consulta deve mostrar que a conta de Compartilhamento de Dados 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á pausado.

  • O processo de instantâneo ou o armazenamento de dados de destino não oferece 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 é bloqueado por outros processos. O Compartilhamento de Dados do Azure não bloqueia esses armazenamentos de dados. Mas os bloqueios existentes nesses armazenamentos de dados podem fazer com que um instantâneo falhe.

  • 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 de uma tabela nos dados de origem, o Compartilhamento de Dados do Azure 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 descartada.

  • Um arquivo CSV de destino é gerado, mas os dados não podem ser lidos no Excel. Você pode ver esse problema quando a tabela SQL de origem contém dados que incluem caracteres não ingleses. No Excel, selecione a guia Obter dados e escolha o arquivo CSV. Selecione a origem do arquivo 65001: Unicode (UTF-8) e carregue os dados.

Atualizar agendamento de snapshot

Depois que o provedor de dados atualiza o agendamento de instantâneo para o compartilhamento enviado, o consumidor de dados precisa desabilitar o agendamento de instantâneo anterior e, em seguida, habilitar o agendamento de instantâneo atualizado para o compartilhamento recebido. O agendamento de instantâneo é armazenado em UTC e mostrado na interface do usuário como a hora local do computador. Ele não se ajusta automaticamente para o horário de verão.

Partilha no local

O mapeamento de 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 para o cluster do Azure Data Explorer. Essa permissão normalmente faz parte da função de Colaborador.
  • O cluster de origem ou destino do Azure Data Explorer está pausado.
  • O cluster do Azure Data Explorer de origem é EngineV2 e o destino é EngineV3 ou vice-versa. Não há suporte para o compartilhamento entre clusters do Azure Data Explorer de diferentes versões de mecanismo.

Próximos passos

Para saber como começar a partilhar dados, avance para o tutorial Partilhar dados .

Para saber como receber dados, continue para o tutorial Aceitar e receber dados .