Partilhar via

SqlPackage para banco de dados SQL no Microsoft Fabric

  • Artigo

Aplica-se a:✅Banco de dados SQL no Microsoft Fabric

Neste tutorial, você aprenderá a trabalhar com SqlPackage em seu banco de dados SQL no Fabric.

SqlPackage é uma CLI que fornece portabilidade de banco de dados e implantações de banco de dados.

  • A portabilidade (importação/exportação) de um banco de dados gerenciado no Azure ou no Fabric garante que seus dados sejam portáteis para outras plataformas, incluindo o SQL Server ou a Instância Gerenciada SQL do Azure, caso você queira migrar mais tarde.
  • A mesma portabilidade também permite determinados cenários de migração por meio de cópias de banco de dados independentes (.bacpac) com operações de importação/exportação.

SqlPackage também pode permitir implantações fáceis de banco de dados de alterações incrementais em objetos de banco de dados (novas colunas em tabelas, alterações em procedimentos armazenados existentes, etc.).

  • SqlPackage pode extrair um .dacpac arquivo que contém as definições de objetos em um banco de dados e publicar um .dacpac arquivo para aplicar esse estado de objeto a um banco de dados novo ou existente.
  • A operação de publicação também se integra com projetos SQL, o que permite ciclos de desenvolvimento offline e mais dinâmicos para bancos de dados SQL.

Pré-requisitos

Configurar

SqlPackage está disponível para Windows, macOS e Linux como uma ferramenta dotnet. Você pode instalá-lo usando o seguinte comando:

dotnet tool install --global Microsoft.SqlPackage

Como uma ferramenta dotnet global, SqlPackage está disponível em seu terminal a sqlpackage partir de qualquer pasta.

Importar um banco de dados com SqlPackage

A .bacpac é uma cópia portátil de um banco de dados, útil para alguns cenários de migração e teste. Você pode importar isso .bacpac para um banco de dados SQL vazio.

Nota

A .bacpac não é um backup ou um substituto para recursos de backup/restauração. Para obter mais informações sobre backups no banco de dados SQL de malha, consulte Backups automáticos no banco de dados SQL no Microsoft Fabric e Restaurar a partir de um backup no banco de dados SQL no Microsoft Fabric.

  1. Se estiver usando um .bacpac do seu ambiente do Banco de Dados SQL do Azure, talvez seja necessário alterar o banco de dados de origem para atender à área de superfície T-SQL do banco de dados SQL de malha.

  2. Crie seu novo banco de dados SQL no Fabric como de costume por meio da interface do Fabric.

  3. Copie a cadeia de conexão das configurações.

    Captura de tela do portal Fabric mostrando a página Cadeias de conexão do banco de dados SQL.

  4. Use o comando import from terminal na pasta sqlpackage. Forneça ao seu proprietário <servername> e <database_name>.

    sqlpackage /action:import /sourcefile:"C:\DatabaseName.bacpac" /targetconnectionstring:"Data Source=tcp:<server_name>.database.windows.net,1433;Initial Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive"
    • Substitua a cadeia de conexão na caixa de diálogo de configurações do banco de dados SQL.
    • Substitua .bacpac o sourcefile valor pelo nome (DatabaseName) e location na máquina local.

Para obter mais informações sobre importação, consulte SqlPackage import.

Exportar um banco de dados com SqlPackage

Exportar a .bacpac é a operação inversa, onde o seu targetfile é um .bacpac e o seu sourceconnectionstring pode ser encontrado na caixa de diálogo de configurações do banco de dados SQL, como no exemplo anterior. Forneça ao seu proprietário <servername> e <database_name>. Por exemplo:

sqlpackage.exe /action:export /targetfile:"C:\DatabaseName.bacpac" /sourceconnectionstring:"Data Source=tcp:<server_name>.database.windows.net,1433;Initial    Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive"

Para obter mais informações sobre exportação, consulte SqlPackage export.

Extrair e publicar

Diagrama de como os projetos de banco de dados SQL podem mover alterações de esquema.

A .dacpac é um arquivo de modelo de esquema de banco de dados, contendo definições para tabelas, procedimentos armazenados e outros objetos no banco de dados de origem.

SqlPackage é capaz de implantar um .dacpac em um novo banco de dados (vazio) ou atualizar incrementalmente um banco de dados existente para corresponder ao estado desejado .dacpac .

  • Extract cria um .dacpac ou arquivos sql a partir de um banco de dados existente.
  • Publicar implanta um .dacpac em um banco de dados.

A sintaxe de publicação SqlPackage é semelhante aos comandos import/export.

Conteúdos relacionados