Compartir a través de

Desarrollo de proyectos de almacenamiento en Visual Studio Code

Esto se aplica a:✅ Almacén en Microsoft Fabric

Obtenga información sobre cómo configurar un proyecto de base de datos para Fabric Data Warehouse en Visual Studio Code. Creará un nuevo proyecto, definirá objetos de esquema, compilará y validará el proyecto y lo publicará en el almacenamiento.

Prerrequisitos

Antes de empezar, asegúrese de que:

  • Tener acceso a un elemento de almacenamiento existente dentro de un área de trabajo de Fabric con permisos de colaborador o superior.
  • Instale Visual Studio Code en la estación de trabajo.
  • Instale el SDK de .NET para compilar y publicar proyectos de base de datos.
  • Instale dos extensiones de Visual Studio Code: Proyectos de Base de Datos SQL y SQL Server (mssql).
    • Puede instalar las extensiones necesarias directamente desde Marketplace de Visual Studio Code si busca "Proyectos de SQL Database" o "SQL Server (mssql)".

Creación de un nuevo proyecto de base de datos

Puede crear un proyecto de base de datos desde cero o un almacén existente.

Opción 1: Crear un nuevo proyecto de base de datos a partir de la paleta de comandos en Visual Studio Code

  1. Abra Visual Studio Code.

  2. Abra la paleta de comandos (Ctrl+Shift+P o Cmd+Shift+P en Mac).

  3. Busque Proyectos de base de datos: Nuevo.

  4. Seleccione Tipo de proyecto de base de datos como Base de datos de SQL Server.

  5. Elija un nombre de proyecto y seleccione la ubicación de la carpeta local.

  6. Elija Synapse Data Warehouse en Microsoft Fabric como plataforma de destino.

  7. Cuando se le solicite, seleccione Sí (recomendado) para un proyecto de estilo SDK.

    Importante

    Solo se admiten proyectos de estilo SDK para Fabric Data Warehouse.

  8. Seleccione Sí a la pregunta ¿Desea configurar la compilación del proyecto SQL como configuración de compilación predeterminada para esta carpeta?

  9. Seleccione Sí para confiar en los autores de los archivos de esta carpeta.

Opción 2: Crear un nuevo proyecto de base de datos a partir de la extensión Proyectos de base de datos

  1. En Visual Studio Code, elija el icono de extensión Proyectos de base de datos en la barra de actividades.

  2. En el panel Proyectos de base de datos , seleccione Crear nuevo.

    Captura de pantalla de Visual Studio Code que muestra el panel de extensión Proyectos de base de datos y el botón Crear nuevo.

  3. Seleccione Tipo de proyecto de base de datos como Base de datos de SQL Server.

  4. Elija un nombre de proyecto y seleccione la ubicación de la carpeta local.

  5. Elija Synapse Data Warehouse en Microsoft Fabric como plataforma de destino.

  6. Cuando se le solicite, seleccione Sí (recomendado) para un proyecto de estilo SDK. Solo se admiten proyectos de estilo SDK para Fabric Data Warehouse.

  7. Seleccione Sí a la pregunta ¿Desea configurar la compilación del proyecto SQL como configuración de compilación predeterminada para esta carpeta?

  8. Seleccione Sí para confiar en los autores de los archivos de esta carpeta.

Opción 3: Crear un proyecto de base de datos a partir de un almacenamiento existente

  1. En primer lugar, cree un nuevo perfil de conexión para el almacenamiento en Visual Studio Code.

    1. Seleccione la extensión de SQL Server en Visual Studio Code en la barra de actividades.
    2. Proporcione un nombre de perfil. Elija Parámetros.
    3. Proporcione el nombre del servidor. En el portal de Fabric, en la configuración de su almacén, recupere la cadena del punto de conexión SQL. (Esto es diferente del punto de conexión de SQL Analytics.) <server unique ID>.datawarehouse.fabric.microsoft.com tiene el siguiente aspecto. Este es el nombre del servidor.
    4. En Tipo de autenticación, use Microsoft Entra ID - Universal compatible con MFA. Autentíquese con el identificador de Microsoft Entra.
    5. Proporcione otra información como predeterminada o desee y seleccione Conectar.

  2. En Visual Studio Code, elija el icono de extensión Proyectos de base de datos en la barra de actividades.

  3. Seleccione el botón ... de opciones del panel Proyectos de base de datos y elija la opción Crear proyecto a partir de base de datos .

    Captura de pantalla de Visual Studio Code que muestra la opción Crear proyecto desde base de datos.

  4. Elija el almacén en los perfiles de conexión existentes.

  5. Proporcione un nombre de proyecto y elija una carpeta de proyecto en la estación de trabajo.

  6. En Estructura de carpetas, seleccione Esquema/Tipo de objeto (recomendado).

  7. En Incluir permisos en el proyecto, seleccione No (valor predeterminado).

  8. En proyecto de estilo SDK, seleccione Sí (recomendado) .

  9. Seleccione Sí a la pregunta ¿Desea configurar la compilación del proyecto SQL como configuración de compilación predeterminada para esta carpeta?

  10. Visual Studio Code extrae los archivos de proyecto del proyecto de almacenamiento.

    Captura de pantalla de Visual Studio Code que muestra la notificación de progreso de la extracción de archivos del proyecto.

  11. Una vez completada la extracción con éxito, verá la siguiente notificación: "Extraer archivos de proyecto: Exitosa. Completado".

  12. Seleccione Sí para confiar en los autores de los archivos de esta carpeta.

Nuevo proyecto de base de datos para tu almacén

El nuevo proyecto de base de datos de tu almacén se muestra en el menú Proyectos de base de datos SQL.

Captura de pantalla de Visual Studio Code que muestra el nuevo proyecto de base de datos para AdventureWorksDW2022.

La estructura del proyecto tiene este aspecto:

 | Project Name
 ├── Database References
 ├── SQLCMD Variables
 ├── .vscode/
 └── schema/
     ├── Functions
     ├── Tables
     └── Views

Configuración del proyecto de base de datos

  1. Haga clic con el botón derecho en el proyecto y seleccione Editar archivo .sqlproj.

    Captura de pantalla de Visual Studio Code y el menú contextual de un proyecto de base de datos. La opción Editar archivo sqlproj está resaltada.

  2. Compruebe que la versión más reciente del SDK de Microsoft.Build.Sql está en el archivo . Por ejemplo, en el archivo .sqlproj, cambie la versión de Microsoft.Build.Sql a 2.0.0.

       <Sdk Name="Microsoft.Build.Sql" Version="2.0.0" />

  3. Compruebe la versión más reciente de Microsoft.SqlServer.Dacpacs.FabricDw y agregue una referencia dentro del Project/ItemGroup nodo XML. Por ejemplo:

       <PackageReference Include="Microsoft.SqlServer.Dacpacs.FabricDw" Version="170.0.2" />

    Así es como debería verse tu proyecto de base de datos para un almacén después de las actualizaciones.

     <?xml version="1.0" encoding="utf-8"?>
 <Project DefaultTargets="Build">
   <Sdk Name="Microsoft.Build.Sql" Version="2.0.0" />
   <PropertyGroup>
     <Name>DatabaseProject715wh</Name>
     <ProjectGuid>{2E278BCC-F118-4DDB-9255-94697F2930B4}</ProjectGuid>
     <DSP>Microsoft.Data.Tools.Schema.Sql.SqlDwUnifiedDatabaseSchemaProvider</DSP>
     <ModelCollation>1033, CI</ModelCollation>
   </PropertyGroup>
   <ItemGroup>
     <None Include=".vscode\tasks.json" />
     <PackageReference Include="Microsoft.SqlServer.Dacpacs.FabricDw" Version="170.0.2" />
   </ItemGroup>
   <Target Name="BeforeBuild">
     <Delete Files="$(BaseIntermediateOutputPath)\project.assets.json" />
   </Target>
 </Project>

  4. Guarde el .sqlproj archivo. En la solicitud para recargar su proyecto de base de datos, debería seleccionar Sí.

Importante

El equipo de Fabric Data Warehouse publica con frecuencia nuevas versiones de paquetes NuGet. Dado que los valores de versión predeterminados del .sqlproj archivo pueden cambiar con el tiempo, asegúrese de actualizarlos en el proyecto local para mantenerse alineados con las versiones más recientes disponibles de NuGet para Microsoft.SqlServer.Dacpacs.FabricDw.

Agregar o actualizar objetos de base de datos

Puede definir o modificar objetos de base de datos como tablas, vistas, procedimientos almacenados y funciones dentro del proyecto de almacenamiento.

En la carpeta de un esquema, por ejemplo dbo, agregue, elimine o modifique las definiciones de T-SQL de los objetos del almacén de datos. Para modificar un objeto existente, abra su archivo correspondiente .sql y actualice la definición según sea necesario.

Al compilar el proyecto, todos los objetos nuevos y actualizados se validan e incluyen en el archivo {project folder location}/bin/debug/{project name}.dacpac dacpac generado.

Los cambios realizados aquí son solo para el proyecto de base de datos y no se reflejan en Microsoft Fabric hasta que compile y publique el proyecto.

Compilación y validación del proyecto

  1. Abra el proyecto de base de datos si aún no está abierto.

  2. Haga clic con el botón derecho en el proyecto y seleccione Compilar para compilar el proyecto de base de datos.

    Captura de pantalla de Visual Studio Code que muestra la opción Compilar el proyecto de base de datos.

  3. La compilación debe ser exitosa. Corrija los errores en función de los mensajes proporcionados en la salida del evento de compilación.

Nota:

Actualmente, el terminal predeterminado de Visual Studio Code debe ser PowerShell para que el proceso de compilación de la extensión Proyectos de base de datos se realice correctamente. En la paleta de comandos, elija Terminal: Seleccione Perfil predeterminado y, a continuación, seleccione PowerShell.

Publicación en Fabric Data Warehouse

Después de compilar el proyecto, publíquelo en el almacén de destino. La publicación crea un script para resolver la diferencia entre el proyecto de base de datos y el almacenamiento real y ejecuta un script para que el almacenamiento coincida con el proyecto. El modelo compilado del esquema de almacenamiento en un archivo .dacpac se puede implementar en un almacén de destino.

  1. Haga clic con el botón derecho en el proyecto y seleccione Publicar.

  2. Elija Publicar en un servidor SQL Server existente.

  3. En Seleccionar perfil de publicación que se va a cargar, la primera vez que publique, elija No usar perfil.

    • Puede guardar opciones para publicar el almacén en un perfil de publicación. Cuando haya terminado, se le dará la opción en una notificación de Visual Studio Code para guardar las opciones de publicación que acaba de usar para un archivo de perfil de publicación.
    • Puede volver a usar el perfil de publicación en el futuro al publicar su proyecto en el almacén. Es posible que tenga diferentes opciones de perfil para diferentes almacenes o para entornos diferentes en los entornos de desarrollo, pruebas, aceptación y producción.

  4. Elija el perfil de conexión de Fabric Data Warehouse de la lista.

  5. Elija el nombre del almacén de destino.

  6. En la opción Elegir acción , puede generar script para revisar el script antes de publicarlo o publicar un proyecto en un almacenamiento.

    • La primera vez que quiera implementar los cambios, debe generar el script cuidadosamente y revisar el T-SQL resultante que se aplicará al almacenamiento de destino. No se realizan cambios en el almacén de destino.
    • Si elige Publicar, los cambios se escribirán en el almacén de destino.

    Captura de pantalla de Visual Studio Code que muestra la notificación Deploy dacpac: In progress (Implementar dacpac: en curso).

  7. En la notificación ¿Desea guardar la configuración en un perfil (.publish.xml)?, elija Sí y guarde las opciones de perfil de publicación para la próxima vez que necesite publicar.

Configuraciones de implementación importantes para proyectos de almacenes

Al implementar proyectos de base de datos en Fabric Data Warehouse, varias configuraciones controlan los cambios de esquema y pueden afectar a la integridad de los datos. Úselo con precaución.

  • BlockOnPossibleDataLoss

    • Lo que hace: Impide la implementación si hay un riesgo de pérdida de datos (por ejemplo, quitar una columna o tabla que contenga datos).
    • Recomendación: Establezca siempre True en producción para proteger los datos críticos.
    • Cautela: Si se establece en False , se permite la implementación incluso si se pueden perder datos. Use solo en entornos controlados (por ejemplo, desarrollo y pruebas).

  • DropObjectsNotInSource

    • Lo que hace: Quita los objetos de la base de datos de destino que no están presentes en el origen del proyecto.
    • Recomendación: Use en entornos de desarrollo y pruebas para limpiar objetos sobrantes.
    • Cautela: El uso DropObjectsNotInSource de en producción puede eliminar objetos y datos importantes. Compruebe dos veces antes de habilitar.

  • Pre-Deployment Scripts

    • Lo que hace: Ejecuta scripts SQL personalizados antes de la implementación del esquema.
    • Usos comunes:
      • Archivar o realizar copias de seguridad de datos antes de eliminar tablas
      • Deshabilitación de restricciones o desencadenadores temporalmente
      • Limpieza de objetos heredados
    • Cautela: Asegúrese de que los scripts son idempotentes y no introducen cambios de esquema que entran en conflicto con la implementación.

Sugerencia

Cuando un proceso de implementación es idempotente, se puede ejecutar varias veces sin causar problemas y se puede implementar en varias bases de datos sin necesidad de predeterminar su estado.

  • Post-Deployment Scripts

    • Lo que hace: Ejecuta scripts SQL personalizados después de la implementación del esquema.
    • Usos comunes:
      • Búsqueda de semilla o datos de referencia
      • Volver a habilitar restricciones o desencadenadores
      • Historial de registros de implementación
    • Cautela: Evitar operaciones pesadas en tablas grandes en producción; asegúrese de que los scripts se pueden ejecutar varias veces de forma segura si es necesario.

Importante

Revise siempre los scripts de implementación y la configuración antes de publicarlos. Pruebe primero en entornos de desarrollo y pruebas para evitar la pérdida de datos no deseada.

Comprobación de la publicación

Conéctese al almacenamiento y a los objetos de script que se cambiaron o comprobaron mediante la ejecución de objetos de catálogo del sistema.

  • Last updated on