Partilhar via

Pacotes DACPAC e BACPAC do Banco de Dados SQL no SQL Edge

  • Artigo

Importante

O Azure SQL Edge será desativado em 30 de setembro de 2025. Para obter mais informações e opções de migração, consulte o Aviso de aposentadoria.

Nota

O Azure SQL Edge não suporta mais a plataforma ARM64.

O SQL do Azure no Edge é um motor de base de dados relacional otimizado para implementações de IoT e no edge. Ele foi criado com base nas versões mais recentes do Mecanismo de Banco de Dados Microsoft SQL, que oferece desempenho, segurança e recursos de processamento de consultas líderes do setor. Juntamente com os recursos de gerenciamento de banco de dados relacional líderes do setor do SQL Server, o Azure SQL Edge fornece recursos de streaming integrados para análises em tempo real e processamento de eventos complexos.

O Azure SQL Edge fornece mecanismos nativos para implantar um pacote DACPAC e BACPAC do Banco de Dados SQL durante, ou após a implantação, do SQL Edge.

Os pacotes DACPAC e BACPAC do Banco de Dados SQL podem ser implantados no SQL Edge usando a MSSQL_PACKAGE variável de ambiente. A variável de ambiente pode ser configurada com qualquer um dos seguintes.

  • Um local de pasta local dentro do contêiner SQL que contém os arquivos DACPAC e BACPAC. Essa pasta pode ser mapeada para um volume host usando pontos de montagem ou contêineres de volume de dados.
  • Um caminho de arquivo local dentro do contêiner SQL mapeando para o DACPAC ou o arquivo BACPAC. Esse caminho de arquivo pode ser mapeado para um volume de host usando pontos de montagem ou contêineres de volume de dados.
  • Um caminho de arquivo local dentro do contêiner SQL mapeando para um arquivo zip contendo os arquivos DACPAC ou BACPAC. Esse caminho de arquivo pode ser mapeado para um volume de host usando pontos de montagem ou contêineres de volume de dados.
  • Uma URL SAS de Blob do Azure para um arquivo zip que contém os arquivos DACPAC e BACPAC.
  • Uma URL SAS de Blob do Azure para um DACPAC ou um arquivo BACPAC.

Usar um pacote de DAC do Banco de dados SQL com o SQL Edge

Para implantar (ou importar) um pacote (*.dacpac) de DAC do Banco de Dados SQL ou um arquivo (*.bacpac) BACPAC usando o armazenamento de Blob do Azure e um arquivo zip, siga estas etapas.

  1. Crie/extraia um pacote de DAC ou exporte um arquivo BACPAC usando um dos seguintes mecanismos.

    Se você estiver usando trabalhos de streaming externos como parte do banco de dados, certifique-se de que:

    • O DACPAC gerado captura todos os objetos do SQL Server correspondentes aos fluxos de entrada/saída e aos trabalhos de streaming, mas os trabalhos não serão iniciados automaticamente. Para que o trabalho de streaming externo seja iniciado automaticamente após a implantação, adicione um script pós-implantação que reinicia os trabalhos da seguinte maneira:

      EXEC `sys.sp_stop_streaming_job` @name = N'<JOB NAME>';
GO
EXEC `sys.sp_start_streaming_job` @name = N'<JOB NAME>';
GO

    • Todas as credenciais exigidas pelos trabalhos de streaming externos para acessar fluxos de entrada ou saída são fornecidas como parte do DACPAC.

  2. Compacte o *.dacpac arquivo ou o *.bacpac arquivo e carregue-o em uma conta de armazenamento de Blob do Azure. Para obter mais informações sobre como carregar arquivos no armazenamento de Blobs do Azure, consulte Carregar, baixar e listar blobs com o portal do Azure.

  3. Gere uma assinatura de acesso compartilhado para o arquivo zip usando o portal do Azure. Para obter mais informações, consulte Delegar acesso com assinaturas de acesso compartilhado (SAS).

  4. Atualize a configuração do módulo SQL Edge para incluir o URI de acesso compartilhado para o pacote de DAC. Para atualizar o módulo SQL Edge, siga estas etapas:

    1. No portal do Azure, vá para sua implantação do Hub IoT.
    2. No painel esquerdo, selecione IoT Edge.
    3. Na página IoT Edge, localize e selecione o IoT Edge onde o módulo SQL Edge está implantado.
    4. Na página Dispositivo IoT Edge, selecione Definir módulo.
    5. Na página Definir módulos e selecione o módulo Azure SQL Edge.
    6. No painel Atualizar Módulo de Borda da IoT, selecione Variáveis de Ambiente. Adicione a MSSQL_PACKAGE variável de ambiente e especifique a URL SAS gerada na Etapa 3 acima como o valor para a variável de ambiente.
    7. Selecione Atualizar.
    8. Na página Definir módulos, selecione Rever + criar.
    9. Na página Definir módulos, selecione Criar.

  5. Após a atualização do módulo, os arquivos do pacote são baixados, descompactados e implantados na instância do SQL Edge.

Em cada reinicialização do contêiner do SQL Edge do Azure, o SQL Edge tenta baixar o pacote de arquivos compactados e avaliar se há alterações. Se uma nova versão do arquivo DACPAC for encontrada, as alterações serão implantadas no banco de dados no SQL Edge.

Problema conhecido

Durante algumas implantações de DACPAC ou BACPAC, os usuários podem encontrar um tempo limite de comando, resultando na falha da operação de implantação do DACPAC. Se você encontrar esse problema, use o SQLPackage.exe (ou ferramentas de cliente SQL) para aplicar o DACPAC ou BACPAC manualmente.

Conteúdos relacionados