Compartir a través de

Implementar un proyecto de SSIS desde Visual Studio Code con Transact-SQL

  • Artículo

Se aplica a: SQL Server SSIS Integration Runtime en Azure Data Factory

En esta guía de inicio rápido se muestra cómo usar Visual Studio Code para conectarse a la base de datos del catálogo de SSIS y cómo usar instrucciones Transact-SQL para implementar un proyecto de SSIS almacenado en el catálogo de SSIS.

Visual Studio Code es un editor de código para Windows, macOS y Linux que admite extensiones, incluida la extensión mssql para conectarse a Microsoft SQL Server, Azure SQL Database o Azure Synapse Analytics. Para obtener más información sobre VSCode, consulte Visual Studio Code.

Requisitos previos

Antes de empezar, asegúrese de haber instalado la versión más reciente de Visual Studio Code y cargado la extensión mssql. Para descargar estas herramientas, consulte las páginas siguientes:

Plataformas compatibles

Puede usar la información que aparece en este inicio rápido para implementar un proyecto de SSIS en las siguientes plataformas:

  • SQL Server en Windows.

No puede usar la información que aparece en este inicio rápido para implementar un paquete de SSIS en Azure SQL Database. El procedimiento almacenado catalog.deploy_project espera la ruta de acceso al archivo .ispac en el sistema de archivos local. Para más información sobre cómo implementar y ejecutar paquetes en Azure, vea Migrar cargas de trabajo de SQL Server Integration Services a la nube mediante lift-and-shift.

No puede usar la información que aparece en este inicio rápido para implementar un paquete de SSIS en SQL Server en Linux. Para más información sobre cómo ejecutar paquetes en Linux, vea Extract, transform, and load data on Linux with SSIS (Extraer, transformar y cargar datos en Linux con SSIS).

Establecer el modo de lenguaje en SQL en VSCode

Para habilitar los comandos mssql y T-SQL IntelliSense, ajuste el modo de lenguaje en SQL en Visual Studio Code.

  1. Abra Visual Studio Code y, a continuación, abra una nueva ventana.

  2. Haga clic en Texto sin formato en la esquina inferior derecha de la barra de estado.

  3. En el menú desplegable Seleccionar modo de lenguaje que aparece, seleccione o escriba SQL y, a continuación, presione ENTRAR para establecer el modo de lenguaje en SQL.

Método de autenticación compatible

Consulte Métodos de autenticación para la implementación.

Conectar con la base de datos del catálogo de SSIS

Use Visual Studio Code para establecer una conexión con el catálogo de SSIS.

  1. En VSCode, presione CTRL+MAYÚS+P (o F1) para abrir la paleta de comandos.

  2. Escriba sqlcon y presione ENTRAR.

  3. Presione ENTRAR para seleccionar Create Connection Profile (Crear perfil de conexión). Este paso crea un perfil de conexión para la instancia de SQL Server.

  4. Siga las indicaciones para especificar las propiedades de conexión del nuevo perfil de conexión. Después de especificar cada valor, presione ENTRAR para continuar.

    Configuración Valor sugerido Más información
    Nombre del servidor Nombre completo del servidor
    Nombre de la base de datos SSISDB Nombre de la base de datos a la que se va a conectar.
    Autenticación Inicio de sesión de SQL
    Nombre de usuario La cuenta de administrador del servidor Esta es la cuenta que especificó cuando creó el servidor.
    Contraseña (Inicio de sesión de SQL) La contraseña de la cuenta de administrador del servidor Esta es la contraseña que especificó cuando creó el servidor.
    ¿Desea guardar la contraseña? Sí o no Si no quiere escribir la contraseña cada vez, seleccione Sí.
    Enter a name for this profile (Escriba un nombre para el perfil) Nombre de perfil, como mySSISServer Un nombre de perfil guardado acelera la conexión en inicios de sesión posteriores.

  5. Presione la tecla ESC para cerrar el mensaje de información que indica que el perfil se ha creado y conectado.

  6. Compruebe la conexión en la barra de estado.

Ejecutar el código T-SQL

Ejecute el siguiente código Transact-SQL para implementar un proyecto de SSIS.

  1. En la ventana Editor, escriba la siguiente consulta en la ventana de consulta vacía.

  2. Actualice los valores de parámetro del procedimiento almacenado catalog.deploy_project del sistema.

  3. Presione CTRL+MAYÚS+E para ejecutar el código e implemente el proyecto.

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

Pasos siguientes