Executa um pacote SSIS a partir de Visual Studio Code com Transact-SQL

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

Este quickstart demonstra como usar Visual Studio Code para se ligar à base de dados do Catálogo SSIS e, depois, usar instruções Transact-SQL para executar um pacote SSIS armazenado no Catálogo SSIS.

Visual Studio Code é um editor de código para Windows, macOS e Linux que suporta extensões, incluindo a mssql extensão para ligação ao Microsoft SQL Server, Base de Dados SQL do Azure ou Azure Synapse Analytics. Para mais informações sobre o VS Code, consulte Visual Studio Code.

Pré-requisitos

Antes de começar, certifique-se de que instalou a versão mais recente do Visual Studio Code e carregou a extensão MSSQL para o Visual Studio Code. Para descarregar estas ferramentas, consulte as seguintes páginas:

Plataformas suportadas

Você pode usar as informações neste início rápido para executar um pacote SSIS nas seguintes plataformas:

Não pode usar a informação deste quickstart para executar um pacote SSIS no Linux. Para saber mais sobre como executar pacotes no Linux, veja Extrair, transformar e carregar dados no Linux com SSIS.

Defina o modo de linguagem para SQL no VS Code

Para ativar os comandos mssql e o IntelliSense de T-SQL, defina o modo de linguagem como SQL no Visual Studio Code.

  1. Abre o Visual Studio Code e depois abre uma nova janela.

  2. Clique em Texto simples no canto inferior direito da barra de estado.

  3. No menu pendente Selecionar modo de linguagem que se abre, selecione ou introduza SQL e, em seguida, prima ENTER para definir o modo de linguagem como SQL.

Para o Banco de Dados SQL do Azure, obtenha as informações de conexão

Para executar o pacote no Banco de Dados SQL do Azure, obtenha as informações de conexão necessárias para se conectar ao banco de dados do Catálogo SSIS (SSISDB). Necessita do nome completo do servidor e das informações de login nos procedimentos que se seguem.

  1. Inicie sessão no portal do Azure.
  2. Selecione Bancos de dados SQL no menu à esquerda e, em seguida, selecione o banco de dados SSISDB na página Bancos de dados SQL .
  3. Na página de Visão Geral da sua base de dados, consulte o nome do servidor totalmente qualificado. Para ver a opção Clique para copiar , passe o mouse sobre o nome do servidor.
  4. Se esquecer as informações de login do servidor Base de Dados SQL do Azure, aceda à página do servidor SQL Database para ver o nome do administrador do servidor. Podes repor a palavra-passe se for necessário.

Liga-te à base de dados do Catálogo SSIS

Use o Visual Studio Code para estabelecer uma ligação ao Catálogo SSIS.

Importante

Antes de continuar, certifique-se de que tem o seu servidor, base de dados e informações de login prontas. Se mudares o foco do Visual Studio Code depois de começares a introduzir a informação do perfil de ligação, tens de recomeçar a criar o perfil de ligação.

  1. No VS Code, pressione CTRL+SHIFT+P (ou F1) para abrir a Paleta de Comandos.

  2. Introduza sqlcon e prima ENTER.

  3. Prima ENTER para selecionar Criar Perfil de Ligação. Este passo cria um perfil de ligação para a sua instância do SQL Server.

  4. Siga as instruções para especificar as propriedades da ligação para o novo perfil de ligação. Depois de especificar cada valor, pressione ENTER para continuar.

    Setting Valor sugerido Mais informações
    Nome do servidor O nome do servidor totalmente qualificado Se estiver a ligar-se a um servidor Base de Dados SQL do Azure, o nome está neste formato: <server_name>.database.windows.net.
    Nome da base de dados SSISDB O nome da base de dados à qual se deve ligar.
    Authentication SQL Login: (Início de Sessão do SQL) Com a autenticação SQL Server, pode ligar-se ao SQL Server ou à Base de Dados SQL do Azure. Se estiveres a ligar-te a um servidor Base de Dados SQL do Azure, não podes usar autenticação Windows.
    Nome de utilizador A conta de administrador do servidor Esta conta é a que especificaste quando criaste o servidor.
    Palavra-passe (Login do SQL) A palavra-passe da sua conta de administrador do servidor Esta palavra-passe é a que especificaste quando criaste o servidor.
    Guardar Palavra-passe? Sim ou não Se não quiser introduzir a palavra-passe de cada vez, selecione Sim.
    Insira um nome para este perfil Um nome de perfil, como mySSISServer Um nome de perfil guardado acelera a sua ligação nos logins seguintes.

  5. Pressione a tecla ESC para fechar a mensagem de informação que informa que o perfil foi criado e ligado.

  6. Verifica a tua ligação na barra de estado.

Executar o código T-SQL

Execute o seguinte código Transact-SQL para executar um pacote SSIS.

  1. Na janela do Editor , introduza a seguinte consulta na janela de consulta vazia. (Este código é o código gerado pela opção Script na caixa de diálogo Executar Pacote no SSMS.)

  2. Atualize os valores dos parâmetros na catalog.create_execution procédure armazenada do seu sistema.

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

Declare @execution_id bigint
EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Package.dtsx',
    @execution_id=@execution_id OUTPUT,
    @folder_name=N'Deployed Projects',
	  @project_name=N'Integration Services Project1',
  	@use32bitruntime=False,
	  @reference_id=Null
Select @execution_id
DECLARE @var0 smallint = 1
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id,
    @object_type=50,
	  @parameter_name=N'LOGGING_LEVEL',
	  @parameter_value=@var0
EXEC [SSISDB].[catalog].[start_execution] @execution_id
GO

Conteúdo relacionado

  • Last updated on