Implantar um projeto do SSIS por meio do Visual Studio Code com o Transact-SQL

  • Artigo

Aplica-se a: SQL Server SSIS Integration Runtime no Azure Data Factory

Este guia de início rápido demonstra como usar o Visual Studio Code para se conectar ao banco de dados do Catálogo do SSIS e, em seguida, usar instruções do Transact-SQL para implantar um projeto do SSIS no Catálogo do SSIS.

O Visual Studio Code é um editor de código para Windows, macOS e Linux que dá suporte a extensões, incluindo a extensão mssql, para se conectar ao Microsoft SQL Server, ao Banco de Dados SQL do Azure ou ao Azure Synapse Analytics. Para obter mais informações sobre o VSCode, consulte Visual Studio Code.

Pré-requisitos

Antes de começar, verifique se você instalou a versão mais recente do Visual Studio Code e carregue a extensão mssql. Para baixar essas ferramentas, consulte as seguintes páginas:

Plataformas com suporte

Você pode usar as informações neste guia de início rápido para implantar um projeto do SSIS nas seguintes plataformas:

  • SQL Server no Windows.

Você não pode usar as informações neste guia de início rápido para implantar um pacote do SSIS para o Banco de Dados SQL do Azure. O procedimento armazenado catalog.deploy_project espera o caminho para o arquivo .ispac no sistema de arquivos local. Para obter mais informações sobre como implantar e executar pacotes no Azure, veja Remover e deslocar cargas de trabalho do SQL Server Integration Services para a nuvem.

Você não pode usar as informações neste guia de início rápido para implantar um pacote do SSIS no SQL Server em Linux. Para obter mais informações sobre como executar pacotes no Linux, veja Extrair, transformar e carregar dados no Linux com o SSIS.

Definir o modo de linguagem para SQL no VSCode

Para habilitar comandos do mssql e T-SQL IntelliSense, defina o modo de linguagem para SQL no Visual Studio Code.

  1. Abra o Visual Studio Code e, em seguida, abra uma nova janela.

  2. Clique em Texto sem Formatação no canto inferior direito da barra de status.

  3. No menu suspenso Selecionar modo de linguagem que é aberto, selecione ou insira SQL e, em seguida, pressione ENTER para definir o modo de linguagem para SQL.

Método de autenticação compatível

Confira os métodos de autenticação para implantação.

Conectar-se ao banco de dados de Catálogo do SSIS

Use o Visual Studio Code para estabelecer uma conexão com o Catálogo do SSIS.

  1. No VSCode, pressione CTRL + SHIFT + P (ou F1) para abrir a paleta de comandos.

  2. Digite sqlcon e pressione ENTER.

  3. Pressione ENTER para selecionar Criar Perfil de Conexão. Esta etapa cria um perfil de conexão para a instância do SQL Server.

  4. Siga os prompts para especificar as propriedades de conexão para o novo perfil de conexão. Depois de especificar cada valor, pressione ENTER para continuar.

    Configuração Valor sugerido Obter mais informações
    Nome do servidor O nome do servidor totalmente qualificado
    Nome do banco de dados SSISDB O nome do banco de dados ao qual conectar.
    Autenticação Logon do SQL
    Nome de usuário A conta do administrador do servidor Essa é a conta que você especificou quando criou o servidor.
    Senha (Logon do SQL) A senha para sua conta do administrador do servidor Essa é a senha que você especificou quando criou o servidor.
    Salvar senha? Sim ou não Se você não deseja inserir a senha a cada vez, selecione Sim.
    Inserir um nome para este perfil Um nome de perfil, assim como mySSISServer Um nome de perfil salvo acelera sua conexão em logons subsequentes.

  5. Pressione a tecla ESC para fechar a mensagem de informações que informa que o perfil foi criado e está conectado.

  6. Verifique se sua conexão na barra de status.

Executar o código T-SQL

Execute o seguinte código Transact-SQL para implantar um projeto do SSIS.

  1. Na janela Editor, digite a consulta a seguir na janela de consulta vazia.

  2. Atualizar os valores de parâmetro no procedimento armazenado catalog.deploy_project para seu sistema.

  3. Pressione CTRL+SHIFT+E para executar o código e implantar o projeto.

DECLARE @ProjectBinary AS varbinary(max)
DECLARE @operation_id AS bigint
SET @ProjectBinary = (SELECT * FROM OPENROWSET(BULK '<project_file_path>.ispac', SINGLE_BLOB) AS BinaryData)

EXEC catalog.deploy_project @folder_name = '<target_folder>',
    @project_name = '<project_name',
    @Project_Stream = @ProjectBinary,
    @operation_id = @operation_id out

Próximas etapas