Resolver problemas de gestão do SSIS Integration Runtime

APLICA-SE A: Azure Data Factory Azure Synapse Analytics

Gorjeta

Experimente o Data Factory no Microsoft Fabric, uma solução de análise tudo-em-um para empresas. O Microsoft Fabric abrange tudo, desde a movimentação de dados até ciência de dados, análises em tempo real, business intelligence e relatórios. Saiba como iniciar uma nova avaliação gratuitamente!

Este artigo fornece diretrizes de solução de problemas para problemas de gerenciamento no Tempo de Execução de Integração (IR) do Azure-SQL Server Integration Services (SSIS), também conhecido como IR SSIS.

Descrição geral

Se você tiver algum problema ao provisionar ou desprovisionar o IR do SSIS, verá uma mensagem de erro no portal do Microsoft Azure Data Factory ou um erro retornado de um cmdlet do PowerShell. O erro sempre aparece no formato de um código de erro com uma mensagem de erro detalhada.

Se o código de erro for InternalServerError, o serviço tem problemas transitórios e você deve tentar novamente a operação mais tarde. Se uma nova tentativa não ajudar, entre em contato com a equipe de suporte do Azure Data Factory.

Caso contrário, três dependências externas principais podem causar erros: Banco de Dados SQL do Azure ou Instância Gerenciada SQL do Azure, um script de instalação personalizado e uma configuração de rede virtual.

Problemas com o Banco de Dados SQL ou a Instância Gerenciada SQL

O Banco de Dados SQL ou a Instância Gerenciada SQL é necessário se você estiver provisionando o SSIS IR com um banco de dados de catálogo do SSIS. O IR do SSIS deve ser capaz de acessar o Banco de Dados SQL ou a Instância Gerenciada do SQL. Além disso, a conta de logon do Banco de Dados SQL ou da Instância Gerenciada do SQL deve ter permissão para criar um banco de dados de catálogo do SSIS (SSISDB). Se ocorrer algum erro, será apresentado um código de erro com uma mensagem de exceção SQL detalhada no portal do Data Factory. Utilize as informações na lista a seguir para resolver problemas de códigos de erro.

AzureSqlConnectionFailure

Poderá ver este problema quando estiver a aprovisionar um novo SSIS IR ou enquanto o runtime de integração estiver em execução. Se ocorrer este erro durante o aprovisionamento do runtime de integração, poderá obter uma mensagem de SqlException detalhada na mensagem de erro que indica um dos seguintes problemas:

• Um problema de ligação de rede. Verifique se o nome do host do Banco de dados SQL ou da instância gerenciada do SQL está acessível. Verifique também se nenhuma firewall ou grupo de segurança de rede (NSG) está a bloquear o acesso do SSIS IR ao servidor.
• Falha no início de sessão durante a autenticação do SQL. A conta fornecida não consegue iniciar sessão na base de dados do SQL Server. Confirme que indica a conta de utilizador correta.
• Falha de login durante a autenticação do Microsoft Entra ID (identidade gerenciada). Adicione a identidade gerenciada de sua fábrica a um grupo do Microsoft Entra e verifique se a identidade gerenciada tem permissões de acesso ao servidor de banco de dados do catálogo.
• Limite de tempo da ligação excedido. Este erro é sempre causado por uma configuração relacionada com a segurança. Recomendamos que você:
  1. Crie uma nova VM.
  2. Junte a VM à mesma Rede Virtual de RI do Microsoft Azure se o IR estiver em uma rede virtual.
  3. Instale o SSMS e verifique o status do Banco de Dados SQL ou da Instância Gerenciada SQL.

Para outros problemas, corrija o problema mostrado na mensagem de erro de exceção SQL detalhada. Se você ainda estiver tendo problemas, entre em contato com a equipe de suporte do Banco de dados SQL ou da instância gerenciada do SQL.

Se você vir o erro quando o IR estiver em execução, o grupo de segurança de rede ou as alterações de firewall provavelmente impedirão que o nó de trabalho de IR do SSIS acesse o Banco de Dados SQL ou a Instância Gerenciada do SQL. Desbloqueie o nó de trabalho IR do SSIS para que ele possa acessar o Banco de Dados SQL ou a Instância Gerenciada do SQL.

CatalogCapacityLimitError

Veja como esse tipo de mensagem de erro pode parecer: "O banco de dados 'SSISDB' atingiu sua cota de tamanho. Particione ou exclua dados, descarte índices ou consulte a documentação para possíveis resoluções."

Soluções possíveis:

• Aumente o tamanho da cota do seu SSISDB.
• Altere a configuração do SSISDB para reduzir o tamanho da seguinte forma:
  • Reduzir o período de retenção e o número de versões do projeto.
  • Reduzir o período de retenção do log.
  • Alterar o nível padrão do log.

CatalogDbBelongsToAnotherIR

Esse erro significa que o Banco de Dados SQL ou a Instância Gerenciada SQL já tem um SSISDB e que ele está sendo usado por outro RI. Você precisa fornecer um Banco de Dados SQL ou uma Instância Gerenciada SQL diferente ou então excluir o SSISDB existente e reiniciar o novo IR.

CatalogDbCreationFailure

Este erro pode ocorrer por um dos seguintes motivos:

• A conta de utilizador que está configurada para o SSIS IR não tem permissão para criar a base de dados. Pode conceder ao utilizador a permissão para criar a base de dados.
• Ocorre um erro de tempo limite durante a criação da base de dados, como um tempo limite de execução ou um tempo limite de operação da BD. Deve repetir a operação mais tarde. Se a nova tentativa não funcionar, entre em contato com a equipe de suporte do Banco de Dados SQL ou da Instância Gerenciada SQL.

Para outros problemas, verifique a Mensagem de erro de exceção do SQL e corrija o problema mencionado nos detalhes do erro. Se você ainda estiver tendo problemas, entre em contato com a equipe de suporte do Banco de dados SQL ou da instância gerenciada do SQL.

InvalidCatalogDb

Esse tipo de mensagem de erro tem esta aparência: "Nome do objeto inválido 'catalog.catalog_properties'." Nessa situação, você já tem um banco de dados chamado SSISDB, mas ele não foi criado pelo SSIS IR, ou o banco de dados está em um estado inválido causado por erros no último provisionamento de IR do SSIS. Você pode descartar o banco de dados existente com o nome SSISDB ou configurar um novo Banco de Dados SQL ou Instância Gerenciada SQL para o RI.

Problemas de configuração personalizada

A configuração personalizada fornece uma interface para adicionar os seus próprios passos de configuração durante o aprovisionamento ou a reconfiguração do SSIS IR. Para obter mais informações, veja Personalizar a configuração do Azure-SSIS Integration Runtime.

Verifique se o contentor contém apenas os ficheiros de configuração personalizados necessários; todos os ficheiros no contentor serão transferidos para o nó de trabalho do SSIS IR. Recomendamos que teste o script de configuração personalizada num computador local para corrigir qualquer problema de execução do script antes de o executar no SSIS IR.

O contentor do script de configuração personalizada será verificado enquanto o IR estiver em execução, pois o SSIS IR é atualizado regularmente. Esta atualização requer o acesso ao contentor para transferir o script de configuração personalizada e instalá-lo novamente. O processo também verifica se o contentor está acessível e se existe o ficheiro main.cmd.

Para qualquer erro que envolva a configuração personalizada, você verá um código de erro CustomSetupScriptFailure com subcódigo como CustomSetupScriptBlobContainerInaccessible ou CustomSetupScriptNotFound.

CustomSetupScriptBlobContainerInaccessible

Este erro significa que o SSIS IR não conseguiu aceder ao contentor de blobs do Azure para a configuração personalizada. Verifique se o URI de SAS do contentor está acessível e se não expirou.

Pare o IR se estiver em execução, reconfigure o IR com o novo URI de SAS do contentor de configuração personalizada e reinicie-o.

CustomSetupScriptNotFound

Este erro significa que o SSIS IR não consegue encontrar um script de configuração personalizada (main.cmd) no contentor de blobs. Verifique se o ficheiro main.cmd existe no contentor, que é o ponto de entrada para a configuração personalizada.

CustomSetupScriptExecutionFailure

Este erro significa que a execução do script de configuração personalizada (main.cmd) falhou. Experimente o script no computador local primeiro ou verifique os registos de execução da configuração personalizada no contentor de blobs.

CustomSetupScriptTimeout

Este erro indica que foi excedido o tempo limite de execução do script de configuração personalizada. Garanta que o script pode ser executado silenciosamente, e que não são necessárias entradas interativa, e verifique se o contentor de blobs contem apenas os ficheiros de configuração personalizada necessários. Recomenda-se testar o script no computador local primeiro. Também deve verificar os registos de execução da configuração personalizada no contentor de blobs. O período máximo da configuração personalizada é de 45 minutos antes de exceder o limite de tempo. O período máximo inclui o tempo para transferir todos os ficheiros do contentor e instalá-los no SSIS IR. Se precisar de um período mais extenso, crie um pedido de suporte.

CustomSetupScriptLogUploadFailure

Este erro significa que a tentativa de carregamento dos registos de execução da configuração personalizada para o contentor de blobs falhou. O problema ocorre porque o SSIS IR não tem permissões de escrita no contentor de blobs ou devido a problemas de armazenamento ou rede. Se a configuração personalizada for bem sucedida, este erro não afetará nenhuma função do SSIS, mas os registos estarão ausentes. Se a configuração personalizada falhar com outro erro e o registo não for carregado, este erro será comunicado em primeiro para que o registo possa ser carregado para análise. Além disso, depois deste problema ter sido resolvido, comunicaremos eventuais problemas mais específicos. Se este problema não ficar resolvido após uma nova tentativa, contacte a equipa de suporte do Azure Data Factory.

Configuração da rede virtual

Quando associa o SSIS IR à Rede Virtual do Microsoft Azure, o SSIS IR utiliza a rede virtual que está na subscrição do utilizador. Para obter mais informações, veja Associar um Azure-SSIS Integration Runtime a uma rede virtual. Depois que o SSIS IR for iniciado com êxito, se você encontrar problemas de conexão de rede, você pode tentar usar a ferramenta de conectividade de diagnóstico para diagnosticar o problema por conta própria. Quando ocorrer um problema relacionado com a Rede Virtual, verá um dos erros a seguir.

InvalidVnetConfiguration

Este erro pode ocorrer por vários motivos. Para resolver este erro, veja as secções Proibido, InvalidPropertyValue e MisconfiguredDnsServerOrNsgSettings.

Proibido

Esse tipo de erro pode ser semelhante a este: "SubnetId não está habilitado para conta corrente. O provedor de recursos Microsoft.Batch não está registrado sob a mesma assinatura de VNet."

Estes detalhes significam que o Azure Batch não consegue aceder à rede virtual. Registe o fornecedor de recursos do Microsoft.Batch na mesma subscrição da Rede Virtual.

InvalidPropertyValue

Este tipo de erro pode ser semelhante a um dos seguintes:

• "A VNet especificada não existe ou o serviço Batch não tem acesso a ela."
• "A sub-rede especificada xxx não existe."

Estes erros significam que a rede virtual não existe, o serviço do Azure Batch não pode aceder à rede ou a sub-rede fornecida não existe. Verifique se a rede virtual e a sub-rede existem e se o Azure Batch tem acesso.

MisconfiguredDnsServerOrNsgSettings

Esse tipo de mensagem de erro pode ter esta aparência: "Falha ao provisionar o Integration Runtime na rede virtual. Se as configurações do servidor DNS ou NSG estiverem configuradas, verifique se o servidor DNS está acessível e se o NSG está configurado corretamente."

Nesta situação, provavelmente tem uma configuração personalizada do servidor DNS ou definições do NSG, o que impede que o nome do servidor do Azure requerido pelo SSIS IR seja resolvido ou acedido. Para obter mais informações, veja Configuração da Rede Virtual do SSIS IR. Se os problemas persistirem, contacte a equipa de suporte do Azure Data Factory.

VNetResourceGroupLockedDuringUpgrade

O SSIS IR será atualizado automaticamente de forma regular. Um novo conjunto do Azure Batch é criado durante a atualização e o conjunto do Azure Batch antigo é eliminado. Além disso, os recursos relacionados com a Rede Virtual do conjunto antigo são eliminados e os novos recursos relacionados com a Rede Virtual são criados na sua subscrição. Este erro significa que a eliminação de recursos relacionados com a Rede Virtual do conjunto antigo falhou devido a um bloqueio de eliminação ao nível da subscrição ou do grupo de recursos. Como o cliente controla e define o bloqueio de eliminação, o bloqueio de eliminação deve ser removido nesta situação.

VNetResourceGroupLockedDuringStart

Se o aprovisionamento do SSIS IR falhar, todos os recursos criados serão eliminados. No entanto, se existir um bloqueio de eliminação de recursos ao nível da subscrição ou do grupo de recursos, os recursos da Rede Virtual não serão eliminados conforme o esperado. Para corrigir este erro, remova o bloqueio de eliminação e reinicie o IR.

VNetResourceGroupLockedDuringStop/VNetDeleteLock

Quando parar o SSIS IR, todos os recursos relacionados com a Rede Virtual serão eliminados. Mas a eliminação poderá falhar se existir um bloqueio de eliminação de recursos ao nível da subscrição ou do grupo de recursos. Também aqui o cliente controla e define o bloqueio de eliminação. Portanto, o cliente deve remover o bloqueio de eliminação e parar o SSIS IR novamente.

NodeUnavailable

Este erro ocorre quando o IR está em execução e significa que o IR passou a estar em mau estado de funcionamento. Este erro é sempre causado por uma alteração no servidor DNS ou na configuração NSG que impede que o SSIS IR se ligue a um serviço necessário. Como a configuração do servidor DNS e do NSG é controlada pelo cliente, o cliente deve corrigir os problemas de bloqueio no seu lado. Para obter mais informações, veja Configuração da Rede Virtual do SSIS IR. Se os problemas persistirem, contacte a equipa de suporte do Azure Data Factory.

Configuração de endereços IP públicos estáticos

Quando você ingressa o IR do Azure-SSIS na Rede Virtual do Azure, também pode trazer seus próprios endereços IP públicos estáticos para o RI para que o IR possa acessar fontes de dados que limitam o acesso a endereços IP específicos. Para obter mais informações, veja Associar um Azure-SSIS Integration Runtime a uma rede virtual.

Além dos problemas de rede virtual acima, você também pode encontrar problemas estáticos relacionados a endereços IP públicos. Verifique os seguintes erros para obter ajuda.

InvalidPublicIPSpecified

Esse erro pode ocorrer por vários motivos quando você inicia o IR do Azure-SSIS:

Mensagem de erro	Solução
O endereço IP público estático fornecido já é usado, forneça dois não utilizados para seu Tempo de Execução de Integração do Azure-SSIS.	Você deve selecionar dois endereços IP públicos estáticos não utilizados ou remover referências atuais ao endereço IP público especificado e reiniciar o IR do Azure-SSIS.
O endereço IP público estático fornecido não tem nome DNS, forneça dois deles com nome DNS para seu Tempo de Execução de Integração Azure-SSIS.	Você pode configurar o nome DNS do endereço IP público no portal do Azure, como mostra a imagem abaixo. As etapas específicas são as seguintes: (1) Abra o portal do Azure e vá para a página de recursos deste endereço IP público; (2) Selecione a seção Configuração e configure o nome DNS e, em seguida, clique no botão Salvar ; (3) Reinicie o IR do Azure-SSIS.
A VNet e os endereços IP públicos estáticos fornecidos para seu Tempo de Execução de Integração do Azure-SSIS devem estar no mesmo local.	De acordo com os requisitos da Rede Azure, o endereço IP público estático e a rede virtual devem estar no mesmo local e assinatura. Forneça dois endereços IP públicos estáticos válidos e reinicie o IR do Azure-SSIS.
O endereço IP público estático fornecido é básico, forneça dois padrão para seu Tempo de Execução de Integração do Azure-SSIS.	Consulte SKUs de Endereço IP Público para obter ajuda.

PublicIPResourceGroupLockedDuringStart

Se o provisionamento de IR do Azure-SSIS falhar, todos os recursos que foram criados serão excluídos. No entanto, se houver um bloqueio de exclusão de recursos no nível de assinatura ou grupo de recursos (que contém seu endereço IP público estático), os recursos de rede não serão excluídos conforme o esperado. Para corrigir o erro, remova o bloqueio de exclusão e reinicie o IR.

PublicIPResourceGroupLockedDuringStop

Quando você interrompe o IR do Azure-SSIS, todos os recursos de rede criados no grupo de recursos que contém seu endereço IP público serão excluídos. Mas a exclusão pode falhar se houver um bloqueio de exclusão de recursos no nível de assinatura ou grupo de recursos (que contém seu endereço IP público estático). Remova o bloqueio de exclusão e reinicie o IR.

PublicIPResourceGroupLockedDuringUpgrade

Azure-SSIS IR é atualizado automaticamente em uma base regular. Novos nós IR são criados durante a atualização e os nós antigos serão excluídos. Além disso, os recursos de rede criados (por exemplo, o balanceador de carga e o grupo de segurança de rede) para os nós antigos são excluídos e os novos recursos de rede são criados sob sua assinatura. Este erro significa que a exclusão dos recursos de rede para os nós antigos falhou devido a um bloqueio de exclusão no nível de assinatura ou grupo de recursos (que contém seu endereço IP público estático). Remova o bloqueio de exclusão para que possamos limpar os nós antigos e liberar o endereço IP público estático para os nós antigos. Caso contrário, o endereço IP público estático não pode ser liberado e não poderemos atualizar ainda mais o seu IR.

PublicIPNotUsableDuringUpgrade

Quando você quiser trazer seus próprios endereços IP públicos estáticos, dois endereços IP públicos devem ser fornecidos. Um deles será usado para criar os nós de IR imediatamente e outro será usado durante a atualização do IR. Este erro pode ocorrer quando o outro endereço IP público é inutilizável durante a atualização. Consulte InvalidPublicIPSpecified para possíveis causas.

Gestão de recursos

Tag de recurso não atualizada

Você pode aplicar marcas aos seus recursos do Azure para organizá-las logicamente em uma taxonomia. Enquanto o IR do SSIS estiver em execução, as alterações nas tags de fábrica de dados pai do SSIS IR não entrarão em vigor até que o IR do SSIS seja reiniciado.