Partager via

Packages SQL Database DACPAC et BACPAC dans SQL Edge

  • Article

Important

Azure SQL Edge sera mis hors service le 30 septembre 2025. Pour plus d’informations et pour connaître les options de migration, consultez l’Avis de mise hors service.

Remarque

Azure SQL Edge ne prend plus en charge la plateforme ARM64.

Azure SQL Edge est un moteur de base de données relationnelle optimisé conçu pour les déploiements IoT et de périphérie. Il repose sur les dernières versions du moteur de base de données Microsoft SQL, qui fournit des fonctionnalités de performances, de sécurité et de traitement des requêtes de pointe. Avec les fonctionnalités de gestion de base de données relationnelle de SQL Server les plus performantes du marché, Azure SQL Edge offre des fonctionnalités de diffusion en continu intégrées pour l’analyse en temps réel et le traitement des événements complexes.

Azure SQL Edge fournit des mécanismes natifs pour déployer un package DACPAC et BACPAC SQL Database pendant ou après le déploiement de SQL Edge.

Vous pouvez déployer les packages DACPAC et BACPAC SQL Database sur SQL Edge à l’aide de la variable d’environnement MSSQL_PACKAGE. Vous pouvez configurer la variable d’environnement avec l’un des éléments suivants.

  • Emplacement du dossier local dans le conteneur SQL contenant les fichiers DACPAC et BACPAC. Ce dossier peut être mappé à un volume hôte à l’aide de points de montage ou de conteneurs de volume de données.
  • Chemin du fichier local dans le mappage du conteneur SQL au fichier DACPAC ou BACPAC. Ce dossier peut être mappé à un volume hôte à l’aide de points de montage ou de conteneurs de volume de données.
  • Chemin du fichier local dans le mappage du conteneur SQL à un fichier zip contenant les fichiers DACPAC ou BACPAC. Ce dossier peut être mappé à un volume hôte à l’aide de points de montage ou de conteneurs de volume de données.
  • URL SAS de blob Azure pointant vers un fichier zip contenant les fichiers DACPAC et BACPAC.
  • URL SAS de blob Azure pointant vers un fichier DACPAC ou BACPAC.

Utiliser un package DAC SQL Database avec SQL Edge

Pour déployer (ou importer) un package DAC (*.dacpac) ou un fichier BACPAC (*.bacpac) SQL Database à l’aide du stockage Blob Azure et d’un fichier zip, suivez ces étapes.

  1. Créez/extrayez un package DAC ou exportez un fichier BACPAC à l’aide de l’un des mécanismes suivants.

    Si vous utilisez des travaux de streaming externes dans le cadre de la base de données, vérifiez que :

    • Le DACPAC généré capture tous les objets SQL Server correspondant aux flux d’entrée/ de sortie et aux travaux de streaming, mais les travaux ne sont pas démarrés automatiquement. Pour que le travail de diffusion en continu externe démarre automatiquement après le déploiement, ajoutez un script post-déploiement qui redémarre les travaux comme suit :

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

    • Toutes les informations d’identification requises par les travaux de streaming externes pour accéder aux flux d’entrée ou de sortie sont fournies dans le cadre du DACPAC.

  2. Compressez le *.bacpac ou le fichier *.dacpac, et chargez-le dans un compte de stockage d’objets blob Azure. Pour plus d’informations sur le chargement de fichiers dans Stockage Blob Azure, consultez Charger, télécharger et lister les objets blob avec le portail Azure.

  3. Générez une signature d’accès partagé pour le fichier zip à partir du portail Azure. Pour plus d’informations, consultez Déléguer l’accès avec des signature d’accès partagé (SAP).

  4. Mettez à jour la configuration du module SQL Edge pour inclure l’URI d’accès partagé du package DAC. Pour mettre à jour le module SQL Edge, procédez comme suit :

    1. Sur le portail Azure, accédez à votre déploiement IoT Hub.
    2. Dans le volet gauche, sélectionnez IoT Edge.
    3. Dans la page IoT Edge, recherchez et sélectionnez l’IoT Edge dans lequel le module SQL Edge est déployé.
    4. Dans la page Appareil IoT Edge, sélectionnez Définir des modules.
    5. Dans la page Définir des modules, sélectionnez le module Azure SQL Edge.
    6. Dans le volet Mettre à jour le module IoT Edge, sélectionnez Variables d’environnement. Ajoutez la variable d’environnement MSSQL_PACKAGE et spécifiez l’URL SAP générée à l’étape 3 ci-dessus en tant que valeur pour la variable d’environnement.
    7. Sélectionnez Mettre à jour.
    8. Sur la page Définir des modules, sélectionnez Vérifier + créer.
    9. Sur la page Définir des modules, sélectionnez Créer.

  5. Après la mise à jour du module, les fichiers de package sont téléchargés, décompressés et déployés pour l’instance SQL Edge.

À chaque redémarrage du conteneur Azure SQL Edge, SQL Edge tente de télécharger le package de fichiers compressé et d’évaluer les modifications. Si une nouvelle version du fichier DACPAC est trouvée, les modifications sont déployées sur la base de données dans SQL Edge.

Problème connu

Pendant certains déploiements DACPAC ou BACPAC, les utilisateurs peuvent rencontrer une expiration de commande, entraînant l’échec de l’opération de déploiement de DACPAC. Si vous êtes confronté à ce problème, utilisez SQLPackage.exe (ou les outils clients SQL) pour appliquer manuellement le déploiement de DACPAC ou BACPAC.

Contenu connexe