Executar pacotes SSIS usando o Agente de Instância Gerenciada SQL do Azure

  • Artigo

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 descreve como executar um pacote do SQL Server Integration Services (SSIS) usando o Agente de Instância Gerenciada SQL do Azure. Esse recurso fornece comportamentos semelhantes a quando você agenda pacotes SSIS usando o SQL Server Agent em seu ambiente local.

Com esse recurso, você pode executar pacotes SSIS armazenados no SSISDB em uma Instância Gerenciada SQL, um sistema de arquivos como Arquivos do Azure ou um repositório de pacotes de tempo de execução de integração Azure-SSIS.

Pré-requisitos

Para usar esse recurso, baixe e instale o SQL Server Management Studio (SSMS) mais recente. Detalhes de suporte de versão como abaixo:

  • Para executar pacotes no SSISDB ou no sistema de arquivos, instale o SSMS versão 18.5 ou superior.
  • Para executar pacotes no repositório de pacotes, instale o SSMS versão 18.6 ou superior.

Você também precisa provisionar um tempo de execução de integração Azure-SSIS no Azure Data Factory. Ele usa uma instância gerenciada SQL como um servidor de ponto de extremidade.

Executar um pacote SSIS no SSISDB

Neste procedimento, você usa o SQL Managed Instance Agent para invocar um pacote SSIS armazenado no SSISDB.

  1. Na versão mais recente do SSMS, conecte-se a uma instância gerenciada do SQL.

  2. Crie um novo trabalho de agente e uma nova etapa de trabalho. Em SQL Server Agent, clique com o botão direito do mouse na pasta Trabalhos e selecione Novo Trabalho.

    Selections for creating a new agent job

  3. Na página Nova Etapa do Trabalho, selecione Pacote do SQL Server Integration Services como o tipo.

    Selections for creating a new SSIS job step

  4. Na guia Pacote, selecione Catálogo SSIS como o local do pacote.

  5. Como o SSISDB está em uma instância gerenciada do SQL, não é necessário especificar a autenticação.

  6. Especifique um pacote SSIS do SSISDB.

    Package tab with selections for the package source type

  7. Na guia Configuração, você pode:

    • Especifique os valores dos parâmetros em Parâmetros.
    • Substitua valores em Gerenciadores de Conexões.
    • Substitua a propriedade e escolha o nível de log em Avançado.

    Configuration tab with selections for the package source type

  8. Selecione OK para salvar a configuração do trabalho do agente.

  9. Inicie o trabalho do agente para executar o pacote SSIS.

Executar um pacote SSIS no sistema de arquivos

Neste procedimento, você usa o SQL Managed Instance Agent para executar um pacote SSIS armazenado no sistema de arquivos.

  1. Na versão mais recente do SSMS, conecte-se a uma instância gerenciada do SQL.

  2. Crie um novo trabalho de agente e uma nova etapa de trabalho. Em SQL Server Agent, clique com o botão direito do mouse na pasta Trabalhos e selecione Novo Trabalho.

    Selections for creating a new agent job

  3. Na página Nova Etapa do Trabalho, selecione Pacote do SQL Server Integration Services como o tipo.

    Selections for creating a new SSIS job step

  4. Na guia Pacote:

    1. Em Local do pacote, selecione Sistema de arquivos.

    2. Para o tipo de fonte de arquivo:

      • Se o seu pacote for carregado nos Arquivos do Azure, selecione Compartilhamento de arquivos do Azure.

        Options for file source type

        O caminho do pacote é \\<storage account name>.file.core.windows.net\<file share name>\<package name>.dtsx.

        Em Credencial de acesso ao arquivo de pacote, insira o nome da conta de arquivo do Azure e a chave da conta para acessar o arquivo do Azure. O domínio é definido como Azure.

      • Se o pacote for carregado para um compartilhamento de rede, selecione Compartilhamento de rede.

        O caminho do pacote é o caminho UNC do seu arquivo de pacote com sua extensão .dtsx.

        Insira o domínio, o nome de usuário e a senha correspondentes para acessar o arquivo do pacote de compartilhamento de rede.

    3. Se o ficheiro do pacote estiver encriptado com uma palavra-passe, selecione Palavra-passe de encriptação e introduza a palavra-passe .

  5. Na guia Configurações, insira o caminho do arquivo de configuração se precisar de um arquivo de configuração para executar o pacote SSIS. Se você armazenar sua configuração nos Arquivos do Azure, seu caminho de configuração será \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.

  6. Na guia Opções de execução, você pode escolher se deseja usar a autenticação do Windows ou o tempo de execução de 32 bits para executar o pacote SSIS.

  7. Na guia Log, você pode escolher o caminho de log e a credencial de acesso ao log correspondente para armazenar os arquivos de log. Por padrão, o caminho de log é o mesmo que o caminho da pasta do pacote e a credencial de acesso ao log é a mesma que a credencial de acesso ao pacote. Se você armazenar seus logs nos Arquivos do Azure, seu caminho de log será \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>.

  8. Na guia Definir valores, você pode inserir o caminho e o valor da propriedade para substituir as propriedades do pacote.

    Por exemplo, para substituir o valor da variável de usuário, insira seu caminho no seguinte formato: \Package.Variables[User::<variable name>].Value.

  9. Selecione OK para salvar a configuração do trabalho do agente.

  10. Inicie o trabalho do agente para executar o pacote SSIS.

Executar um pacote SSIS no repositório de pacotes

Nota

O armazenamento de pacotes não é suportado no IR do Azure-SSIS no Azure Synapse.

Neste procedimento, você usa o SQL Managed Instance Agent para executar um pacote SSIS armazenado no repositório de pacotes IR do Azure-SSIS.

  1. Na versão mais recente do SSMS, conecte-se a uma instância gerenciada do SQL.

  2. Crie um novo trabalho de agente e uma nova etapa de trabalho. Em SQL Server Agent, clique com o botão direito do mouse na pasta Trabalhos e selecione Novo Trabalho.

    Selections for creating a new agent job

  3. Na página Nova Etapa do Trabalho, selecione Pacote do SQL Server Integration Services como o tipo.

    Selections for creating a new SSIS job step

  4. Na guia Pacote:

    1. Em Local do pacote, selecione Loja de pacotes.

    2. Para o caminho do pacote:

      O caminho do pacote é <package store name>\<folder name>\<package name>.

      Options for package store type

    3. Se o ficheiro do pacote estiver encriptado com uma palavra-passe, selecione Palavra-passe de encriptação e introduza a palavra-passe .

  5. Na guia Configurações, insira o caminho do arquivo de configuração se precisar de um arquivo de configuração para executar o pacote SSIS. Se você armazenar sua configuração nos Arquivos do Azure, seu caminho de configuração será \\<storage account name>.file.core.windows.net\<file share name>\<configuration name>.dtsConfig.

  6. Na guia Opções de execução, você pode escolher se deseja usar a autenticação do Windows ou o tempo de execução de 32 bits para executar o pacote SSIS.

  7. Na guia Log, você pode escolher o caminho de log e a credencial de acesso ao log correspondente para armazenar os arquivos de log. Por padrão, o caminho de log é o mesmo que o caminho da pasta do pacote e a credencial de acesso ao log é a mesma que a credencial de acesso ao pacote. Se você armazenar seus logs nos Arquivos do Azure, seu caminho de log será \\<storage account name>.file.core.windows.net\<file share name>\<log folder name>.

  8. Na guia Definir valores, você pode inserir o caminho e o valor da propriedade para substituir as propriedades do pacote.

    Por exemplo, para substituir o valor da variável de usuário, insira seu caminho no seguinte formato: \Package.Variables[User::<variable name>].Value.

  9. Selecione OK para salvar a configuração do trabalho do agente.

  10. Inicie o trabalho do agente para executar o pacote SSIS.

Cancelar a execução do pacote SSIS

Para cancelar a execução do pacote de um trabalho do SQL Managed Instance Agent, execute as seguintes etapas em vez de interromper diretamente o trabalho do agente:

  1. Encontre seu jobId do agente SQL em msdb.dbo.sysjobs.

  2. Encontre o executionId do SSIS correspondente com base na ID do trabalho, usando esta consulta:

    select * from '{table for job execution}' where  parameter_value = 'SQL_Agent_Job_{jobId}' order by execution_id desc

    Se os pacotes SSIS estiverem no SSISDB, use ssisdb.internal.execution_parameter_values como tabela para a execução do trabalho. Se os pacotes SSIS estiverem no sistema de arquivos, use ssisdb.internal.execution_parameter_values_noncatalog.

  3. Clique com o botão direito do mouse no catálogo SSISDB e selecione Operações Ativas.

    "Active Operations" on the shortcut menu for the SSISDB catalog

  4. Pare a operação correspondente com base em executionId.

Conteúdos relacionados

Você também pode agendar pacotes SSIS usando o Azure Data Factory. Para obter instruções passo a passo, consulte Gatilho de evento do Azure Data Factory.