Solucionar problemas de Azure Synapse Analytics, Azure SQL Database, SQL Server, Azure SQL Managed Instance e Amazon RDS para conectores SQL Server em Azure Data Factory e Azure Synapse

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Dica

Data Factory no Microsoft Fabric é a próxima geração de Azure Data Factory, com uma arquitetura mais simples, IA interna e novos recursos. Se você não estiver familiarizado com a integração de dados, comece com Fabric Data Factory. As cargas de trabalho existentes do ADF podem ser atualizadas para Fabric para acessar novos recursos em ciência de dados, análise em tempo real e relatórios.

Este artigo fornece sugestões para solucionar problemas comuns com os conectores Azure Synapse Analytics, Azure SQL Database, SQL Server, Azure SQL Managed Instance e Amazon RDS para conectores SQL Server Azure Data Factory e Azure Synapse.

Código de erro: SqlFailedToConnect

  • Mensagem: Cannot connect to SQL Database: '%server;', Database: '%database;', User: '%user;'. Check the linked service configuration is correct, and make sure the SQL Database firewall allows the integration runtime to access.

  • Causas e recomendações: causas diferentes podem levar a esse erro. Consulte a lista a seguir para análise de possíveis causas e recomendação relacionada.

    Análise da causa Recomendação
    Para Azure SQL, se a mensagem de erro contiver a cadeia de caracteres "SqlErrorNumber=47073", isso significará que o acesso à rede pública será negado na configuração de conectividade. No firewall Azure SQL, defina a opção de acesso à rede pública Deny para No. Para obter mais informações, consulte Azure SQL configurações de conectividade.
    Para Azure SQL, se a mensagem de erro contiver um código de erro SQL, como "SqlErrorNumber=[errorcode]", consulte o guia de solução de problemas do Azure SQL. Para obter uma recomendação, consulte Solucione problemas de conectividade e outros erros com Azure SQL Database e Azure SQL Managed Instance.
    Verifique se a porta 1433 está na lista de permissões do firewall. Para obter mais informações, consulte Ports usados pelo SQL Server.
    Se a mensagem de erro contiver a string “SqlException”, o erro do Banco de Dados SQL indica que alguma operação específica falhou. Para obter mais informações, pesquise pelo código de erro SQL em Erros do mecanismo de banco de dados. Para obter mais ajuda, entre em contato com Azure SQL suporte.
    Se este for um problema transitório (por exemplo, uma conexão de rede instável), adicione nova tentativa na política de atividade para atenuar. Para saber mais, confira Pipelines e atividades.
    Se a mensagem de erro contiver a cadeia de caracteres "Cliente com endereço IP'... ' não tem permissão para acessar o servidor' e você está tentando se conectar ao Azure SQL Database, o erro geralmente é causado por um problema de firewall Azure SQL Database. Na configuração de firewall do SQL Server do Azure, habilite a opção Permitir serviços e recursos do Azure acessar este servidor. Para obter mais informações, consulte Azure SQL Database e Azure Synapse regras de firewall de IP.
    Quando a mensagem de erro contém Login failed for user '<token-identified principal>', esse erro geralmente é causado pela falta de concessão de permissão suficiente à entidade de serviço ou à identidade gerenciada atribuída pelo sistema ou pelo usuário (dependendo do tipo de autenticação escolhido) no banco de dados. Conceda permissão suficiente à entidade de serviço ou à identidade gerenciada atribuída pelo sistema ou pelo usuário no banco de dados.

    Para Azure SQL Database:
        ─ Para usar a autenticação da entidade de serviço, siga Autenticação da entidade de serviço.
        ─ Para usar a autenticação da identidade gerenciada atribuída pelo sistema, siga Autenticação da identidade gerenciada atribuída pelo sistema.
        ─ Para usar a autenticação da identidade gerenciada atribuída pelo usuário, siga Autenticação da identidade gerenciada atribuída pelo usuário.
       
    Para Azure Synapse Analytics:
        ─ Para usar a autenticação da entidade de serviço, siga Autenticação da entidade de serviço.
        - Se você usar a autenticação de identidade gerenciada atribuída pelo sistema, siga Identidades gerenciadas atribuídas pelo sistema para autenticação de recursos do Azure.
        ─ Para usar a autenticação da identidade gerenciada atribuída pelo usuário, siga Autenticação da identidade gerenciada atribuída pelo usuário.
       
    Para Azure SQL Managed Instance:
        ─ Para usar a autenticação da entidade de serviço, siga Autenticação da entidade de serviço.
       ─ Para usar a autenticação da identidade gerenciada atribuída pelo sistema, siga Autenticação da identidade gerenciada atribuída pelo sistema.
       ─ Para usar a autenticação da identidade gerenciada atribuída pelo usuário, siga Autenticação da identidade gerenciada atribuída pelo usuário.
    Se você atender à mensagem de erro que contém The server was not found or was not accessible ao usar Instância Gerenciada de SQL do Azure, esse erro geralmente será causado por não habilitar o ponto de extremidade público Instância Gerenciada de SQL do Azure. Consulte Configurar ponto de extremidade público no Azure SQL Managed Instance para habilitar o ponto de extremidade público do Azure SQL Managed Instance.

Código de erro: SqlOperationFailed

  • Mensagem: A database operation failed. Please search error to get more details.

  • Causas e recomendações: causas diferentes podem levar a esse erro. Consulte a lista a seguir para análise de possíveis causas e recomendação relacionada.

    Análise da causa Recomendação
    Se a mensagem de erro contiver a cadeia de caracteres "SqlException", o Banco de Dados SQL lançará um erro indicando que alguma operação específica falhou. Se o erro de SQL não for claro, tente alterar o banco de dados para o nível de compatibilidade mais recente “150”. Isso pode gerar erros de SQL da versão mais recente. Para obter mais informações, confira a documentação.
    Para obter mais informações sobre como solucionar problemas de SQL, pesquise por código de erro SQL em Erros do mecanismo de banco de dados. Para obter mais ajuda, entre em contato com Azure SQL suporte.
    Se a mensagem de erro contiver a string "PdwManagedToNativeInteropException", isso geralmente é causado por uma incompatibilidade entre os tamanhos das colunas de origem e destino. Verifique o tamanho das colunas de origem e do coletor. Para obter mais ajuda, entre em contato com Azure SQL suporte.
    Se a mensagem de erro contiver "InvalidOperationException", geralmente ela é causada por dados de entrada inválidos. Para identificar em qual linha está o problema, habilite o recurso de tolerância a falhas na atividade de cópia, que pode redirecionar as linhas problemáticas para o armazenamento para uma investigação mais aprofundada. Para saber mais, confira Tolerância a falhas da atividade de cópia.
    Se a mensagem de erro contiver "Tempo limite de execução expirado", geralmente é causada por um tempo limite de consulta excedido. Configure o tempo limite da consulta na origem e o tempo limite de gravação em lote no coletor para aumentar o tempo limite.
    Se a mensagem de erro contiver Cannot find the object "dbo.Contoso" because it does not exist or you do not have permissions. quando você copia dados do híbrido para uma tabela de SQL Server local, ela é causada pela conta SQL atual não tem permissões suficientes para executar solicitações emitidas pelo .NET SqlBulkCopy.WriteToServer ou sua tabela ou banco de dados não existe. Alterne para uma conta SQL mais privilegiada ou verifique se a tabela ou o banco de dados existe.

Código de erro: SqlUnauthorizedAccess

  • Mensagem: Cannot connect to '%connectorName;'. Detail Message: '%message;'

  • Causa: as credenciais estão incorretas ou a conta de entrada não pode acessar o banco de dados SQL.

  • Recomendação: verifique se a conta de entrada tem permissão suficiente para acessar o Banco de Dados SQL.

Código de erro: SqlOpenConnectionTimeout

  • Mensagem: Open connection to database timeout after '%timeoutValue;' seconds.

  • Causa: o problema pode ser uma falha transitória do banco de dados SQL.

  • Recommendation: repita a operação para atualizar a cadeia de conexão do serviço vinculado com um valor de tempo limite de conexão maior.

Código de erro: SqlAutoCreateTableTypeMapFailed

  • Mensagem: Type '%dataType;' in source side cannot be mapped to a type that supported by sink side(column name:'%columnName;') in autocreate table.

  • Causa: a tabela de autocriação não pode atender aos requisitos de origem.

  • Recomendação: atualize o tipo de coluna em mapeamentos ou crie manualmente a tabela de coletor no servidor de destino.

Código de erro: SqlDataTypeNotSupported

  • Mensagem: A database operation failed. Check the SQL errors.

  • Causa: se o problema ocorrer na fonte SQL e o erro estiver relacionado ao estouro de SqlDateTime, o valor dos dados será sobre o intervalo do tipo lógico (1/1/1753 12:00:00 – 31/12/9999 23:59:59).

  • Recomendação: converta o tipo em cadeia de caracteres na consulta SQL de origem ou, no mapeamento de coluna da atividade de cópia, altere o tipo de coluna para String.

  • Causa: se o problema ocorrer no coletor SQL e o erro estiver relacionado ao estouro de SqlDateTime, o valor dos dados estará acima do intervalo permitido na tabela de coletor.

  • Recomendação: atualize o tipo de coluna correspondente para o tipo datetime2 na tabela de destino.

Código de erro: SqlInvalidDbStoredProcedure

  • Mensagem: The specified Stored Procedure is not valid. It could be caused by that the stored procedure doesn't return any data. Invalid Stored Procedure script: '%scriptName;'.

  • Causas e recomendações: causas diferentes podem levar a esse erro. Consulte a lista a seguir para análise de possíveis causas e recomendação relacionada.

    Análise da causa Recomendação
    O procedimento armazenado especificado não é válido. Valide o procedimento armazenado usando as Ferramentas do SQL. Verifique se o procedimento armazenado pode retornar dados.
    A atividade Pesquisa requer que o procedimento armazenado retorne algum valor, mas o código do procedimento armazenado não retorna nenhum valor. Use a Atividade de Procedimento Armazenado se o procedimento armazenado não retornar dados.

Código de erro: SqlInvalidDbQueryString

  • Mensagem: The specified SQL Query is not valid. It could be caused by that the query doesn't return any data. Invalid query: '%query;'

  • Causa: a consulta SQL especificada é inválida. A causa pode ser que a consulta não retorna nenhum dado.

  • Recomendação: valide a consulta SQL usando ferramentas de SQL. Verifique se a consulta pode retornar dados.

Código de erro: SqlInvalidColumnName

  • Mensagem: Column '%column;' does not exist in the table '%tableName;', ServerName: '%serverName;', DatabaseName: '%dbName;'.

  • Causa: a coluna não foi encontrada porque a configuração pode estar incorreta.

  • Recomendação: verifique a coluna na consulta, estrutura no conjunto de dados e mapeamentos na atividade.

Código de erro: SqlBatchWriteTimeout

  • Mensagem: Timeouts in SQL write operation.

  • Causa: o problema pode ser causado por uma falha temporária do banco de dados SQL.

  • Recomendação: repita a operação. Se o problema persistir, contate o suporte do Azure SQL.

Código de erro: SqlBatchWriteTransactionFailed

  • Mensagem: SQL transaction commits failed.

  • Causa: se os detalhes da exceção incluírem continuamente o tempo limite da transação, a latência de rede entre o runtime de integração e o banco de dados será maior que o limite padrão, que é 30 segundos.

  • Recommendation: atualize a string de conexão do serviço vinculado ao SQL com um valor de tempo limite de conexão igual ou superior a 120 e reinicie a atividade.

  • Causa: se os detalhes da exceção intermitentemente mostrarem que a conexão SQL foi interrompida, pode haver uma falha de rede transitória ou um problema do lado do Banco de Dados SQL.

  • Recomendação: repita a atividade e revise as métricas no Banco de dados SQL.

Código de erro: SqlBulkCopyInvalidColumnLength

  • Mensagem: SQL Bulk Copy failed due to receive an invalid column length from the bcp client.

  • Causa: falha na cópia em massa do SQL porque ela recebeu um comprimento de coluna inválido do cliente utilitário de bcp (programa de cópia em massa).

  • Recomendação: para identificar qual linha encontrou o problema, habilite o recurso de tolerância a falhas na atividade de cópia. Isso pode redirecionar linhas problemáticas para o armazenamento, permitindo uma investigação mais detalhada. Para saber mais, confira Tolerância a falhas da atividade de cópia.

Código de erro: SqlConnectionIsClosed

  • Mensagem: The connection is closed by SQL Database.

  • Causa: a conexão SQL é fechada pelo Banco de Dados SQL quando há uma alta execução simultânea e o servidor encerra a conexão.

  • Recomendação: repita a conexão. Se o problema persistir, contate o suporte do Azure SQL.

Código de erro: SqlServerInvalidLinkedServiceCredentialMissing

  • Mensagem: The SQL Server linked service is invalid with its credential being missing.

  • Causa: o serviço vinculado não foi configurado adequadamente.

  • Recomendação: valide e corrija o serviço vinculado ao servidor SQL.

Código de erro: SqlParallelFailedToDetectPartitionColumn

  • Mensagem: Failed to detect the partition column with command '%command;', %message;.

  • Causa: não há chave primária ou chave única na tabela.

  • Recomendação: verifique a tabela para garantir que uma chave primária ou um índice exclusivo seja criado.

Código de erro: SqlParallelFailedToDetectPhysicalPartitions

  • Mensagem: Failed to detect the physical partitions with command '%command;', %message;.

  • Causa: nenhuma partição física foi criada na tabela. Verifique seu banco de dados.

  • Recomendação: confira a referência Criar tabelas e índices particionados para resolver esse problema.

Código de erro: SqlParallelFailedToGetPartitionRangeSynapse

  • Mensagem: Failed to get the partitions for azure synapse with command '%command;', %message;.

  • Causa: nenhuma partição física foi criada na tabela. Verifique seu banco de dados.

  • Recomendação: confira a referência Particionar tabelas em pool SQL dedicado para resolver esse problema.

Mensagem de erro: Falha na conversão de uma cadeia de caracteres em um uniqueidentifier

  • Symptoms: ao copiar dados de uma fonte de dados tabular (como SQL Server) para Azure Synapse Analytics usando a cópia em etapas e o PolyBase, você recebe o seguinte erro:

    ErrorCode=FailedDbOperation,Type=Microsoft.DataTransfer.Common.Shared.HybridDeliveryException, Message=Error happened when loading data into Azure Synapse Analytics., Source=Microsoft.DataTransfer.ClientLibrary,Type=System.Data.SqlClient.SqlException, Message=Conversion failed when converting from a character string to uniqueidentifier...

  • Cause: Azure Synapse Analytics o PolyBase não pode converter uma cadeia de caracteres vazia em um GUID.

  • Resolução: no coletor de atividades Copy, nas configurações do PolyBase, defina a opção padrão de tipo de uso como falso.

Mensagem de erro: Tipo de dados esperado: DECIMAL (x,x), valor incorreto

  • Symptoms: ao copiar dados de uma fonte de dados tabular (como SQL Server) para Azure Synapse Analytics usando a cópia em etapas e o PolyBase, você recebe o seguinte erro:

    ErrorCode=FailedDbOperation,Type=Microsoft.DataTransfer.Common.Shared.HybridDeliveryException, Message=Error happened when loading data into Azure Synapse Analytics., Source=Microsoft.DataTransfer.ClientLibrary,Type=System.Data.SqlClient.SqlException, Message=Query aborted-- the maximum reject threshold (0 rows) was reached while reading from an external source: 1 rows rejected out of total 415 rows processed. (/file_name.txt) Column ordinal: 18, Expected data type: DECIMAL(x,x), Offending value:..

  • Cause: Azure Synapse Analytics o PolyBase não pode inserir uma cadeia de caracteres vazia (valor nulo) em uma coluna decimal.

  • Resolução: no coletor de atividades Copy, nas configurações do PolyBase, defina a opção padrão de tipo de uso como falso.

Mensagem de erro: mensagem de exceção Java: HdfsBridge::CreateRecordReader

  • Symptoms: você copia dados para Azure Synapse Analytics usando o PolyBase e recebe o seguinte erro:

    Message=110802;An internal DMS error occurred that caused this operation to fail. Details: Exception: Microsoft.SqlServer.DataWarehouse.DataMovement.Common.ExternalAccess.HdfsAccessException, Message: Java exception raised on call to HdfsBridge_CreateRecordReader. Java exception message:HdfsBridge::CreateRecordReader - Unexpected error encountered creating the record reader.: Error [HdfsBridge::CreateRecordReader - Unexpected error encountered creating the record reader.] occurred while accessing external file.....

  • Causa: a causa pode ser que o esquema (largura total da coluna) é muito grande (maior que 1 MB). Verifique o esquema da tabela de Azure Synapse Analytics de destino adicionando o tamanho de todas as colunas:

    • Int = 4 bytes
    • Bigint = 8 bytes
    • Varchar(n), char(n), binary(n), varbinary(n) = n bytes
    • Nvarchar(n), nchar(n) = n*2 bytes
    • Data = 6 bytes
    • Datetime/(2), smalldatetime = 16 bytes
    • Datetimeoffset = 20 bytes
    • Decimal = 19 bytes
    • Float = 8 bytes
    • Dinheiro = 8 bytes
    • Smallmoney = 4 bytes
    • Real = 4 bytes
    • Smallint = 2 bytes
    • Tempo = 12 bytes
    • Tinyint = 1 byte

  • Resolução:

    • Reduza a largura da coluna para menos de 1 MB.
    • Ou use uma abordagem de inserção em massa desativando o PolyBase.

Mensagem de erro: a condição especificada usando cabeçalhos condicionais HTTP não foi atendida

  • Symptoms: Você usa uma consulta SQL para extrair dados de Azure Synapse Analytics e recebe o seguinte erro:

    ...StorageException: The condition specified using HTTP conditional header(s) is not met...

  • Cause: Azure Synapse Analytics encontrou um problema ao consultar a tabela externa em Azure Storage.

  • Resolution: execute a mesma consulta no SSMS (SQL Server Management Studio) e verifique se você obtém o mesmo resultado. Se você fizer isso, abra um ticket de suporte para o Azure Synapse Analytics e forneça o nome do servidor e do banco de dados do seu Azure Synapse Analytics.

O nível de desempenho é baixo e causa falha na cópia

  • Symptoms: você copia dados para Azure SQL Database e recebe o seguinte erro: Database operation failed. Error message from database execution : ExecuteNonQuery requires an open and available Connection. The connection's current state is closed.

  • Cause: Azure SQL Database s1 atingiu os limites de E/S (entrada/saída).

  • Resolution: atualize a camada de desempenho Azure SQL Database para corrigir o problema.

Mensagem de erro: a cadeia de caracteres ou os dados binários estão truncados

  • Symptoms: ocorre um erro ao copiar dados para uma tabela de SQL Server do Azure local.

  • Causa: a definição do esquema de tabela SQL tem uma ou mais colunas com menos comprimento do que o esperado.

  • Resolução: para resolver o problema, tente o seguinte:

    1. Para descobrir quais linhas apresentam o problema, aplique a tolerância a falhas do coletor de SQL, especialmente redirectIncompatibleRowSettings.

      Observação

      A tolerância a falhas pode exigir tempo de execução extra, o que pode levar a custos mais elevados.

    2. Verifique novamente os dados redirecionados em relação ao comprimento da coluna do esquema da tabela SQL para ver quais colunas precisam ser atualizadas.

    3. Atualize o esquema da tabela conforme necessário.

Código de erro: FailedDbOperation

  • Mensagem: User does not have permission to perform this action.

  • Recommendation: verifique se o usuário configurado no conector Azure Synapse Analytics deve ter a permissão 'CONTROL' no banco de dados de destino ao usar o PolyBase para carregar dados. Para obter informações detalhadas, confira este documento.

Código de erro: Msg 105208

  • Sintomas: código de erro: Error code: Msg 105208, Level 16, State 1, Line 1 COPY statement failed with the following error when validating value of option 'FROM': '105200;COPY statement failed because the value for option 'FROM' is invalid.'
  • Cause: atualmente, a ingestão de dados usando o comando COPY em uma conta Azure Storage que está usando o novo recurso de particionamento DNS resulta em um erro. O recurso de partição DNS permite que os clientes criem até 5.000 contas de armazenamento por assinatura.
  • Resolutions: provisionar uma conta de armazenamento em uma assinatura que não usa o novo recurso de partição DNS Azure Storage (atualmente em Versão Prévia Pública).

Código de erro: SqlDeniedPublicAccess

  • Mensagem: Cannot connect to SQL Database: '%server;', Database: '%database;', Reason: Connection was denied since Deny Public Network Access is set to Yes. To connect to this server, 1. If you persist public network access disabled, please use Managed Virtual Network IR and create private endpoint. https://docs.microsoft.com/en-us/azure/data-factory/managed-virtual-network-private-endpoint; 2. Otherwise you can enable public network access, set "Public network access" option to "Selected networks" on Azure SQL Networking setting.

  • Causes: Azure SQL Database está definido para negar o acesso à rede pública. Isso requer usar rede virtual gerenciada e criar ponto de extremidade privado para acessar.

  • Recomendação:

    1. Se você insistir em desabilitar o acesso à rede pública, use o runtime de integração de rede virtual gerenciada e crie um ponto de extremidade privado. Para obter mais informações, consulte Azure Data Factory rede virtual gerenciada.

    2. Caso contrário, habilite o acesso à rede pública definindo a opção Public network access para Selected networks na página de configuração Azure SQL Database Networking.

Conteúdo relacionado

Para obter mais ajuda com a solução de problemas, experimente estes recursos:

  • Last updated on