Freigeben über

Bereitstellen von Azure SQL Edge

  • Artikel

Wichtig

Azure SQL Edge wird am 30. September 2025 eingestellt. Weitere Informationen und Migrationsoptionen finden Sie im Einstellungshinweis.

Hinweis

Azure SQL Edge unterstützt die ARM64-Plattform nicht mehr.

Azure SQL Edge ist eine optimierte Engine für relationale Datenbanken, die für IoT- und Azure IoT Edge-Bereitstellungen optimiert ist. Azure SQL Database Edge bietet die Möglichkeit zur Erstellung eines Hochleistungs-Datenspeichers und einer Verarbeitungsschicht für IoT-Anwendungen und -Lösungen. In dieser Schnellstartanleitung erfahren Sie, wie Sie mit dem Erstellen eines Azure SQL Edge-Moduls durch Azure IoT Edge über das Azure-Portal beginnen.

Voraussetzungen

Hinweis

Informationen zum Bereitstellen einer Azure Linux-VM als IoT Edge-Gerät finden Sie in dieser Schnellstartanleitung.

Bereitstellen des Azure SQL Edge-Moduls mit IoT Hub

Azure SQL Edge kann mithilfe von Anweisungen aus Bereitstellen von Modulen über das Azure-Portal bereitgestellt werden. Der Image-URI für Azure SQL Edge ist mcr.microsoft.com/azure-sql-edge:latest.

  1. Geben Sie auf der Seite IoT Edge-Modul hinzufügen die gewünschten Werte für IoT Edge-Modulname, Image-URI, Neustartrichtlinie und Gewünschter Status an.

    Verwenden Sie den folgenden Image-URI abhängig von der Edition, die Sie bereitstellen möchten:

    • Developer Edition - mcr.microsoft.com/azure-sql-edge/developer
    • Premium Edition - mcr.microsoft.com/azure-sql-edge/premium

  2. Geben Sie im Abschnitt Umgebungsvariablen des Bereichs IoT Edge-Modul hinzufügen die gewünschten Werte für die Umgebungsvariablen an. Eine vollständige Liste der Azure SQL Edge-Umgebungsvariablen finden Sie unter Konfigurieren mithilfe von Umgebungsvariablen.

    Parameter Beschreibung
    ACCEPT_EULA Legen Sie diesen Wert auf Y fest, um den Endbenutzerlizenzvertrag zu akzeptieren.
    MSSQL_SA_PASSWORD Legen Sie den Wert fest, um ein sicheres Kennwort für das SQL Edge-Administratorkonto anzugeben.
    MSSQL_LCID Legen Sie den Wert fest, um die gewünschte Sprach-ID festzulegen, die für SQL Edge verwendet werden soll. Beispielsweise steht „1036“ für „Französisch“.
    MSSQL_COLLATION Legen Sie den Wert fest, um die Standardsortierung für SQL Edge festzulegen. Diese Einstellung setzt die Standardzuordnung der Sprach-ID (LCID) für die Sortierung außer Kraft.

  3. Legen Sie die Optionen im Abschnitt Containererstellungsoptionen des Bereichs IoT Edge-Modul hinzufügen nach Bedarf fest.

    • Hostport

      Ordnen Sie den angegebenen Hostport Port 1433 (SQL-Standardport) im Container zu.

    • Bindungen und Einbindungen

      Wenn Sie mehrere SQL Edge-Module bereitstellen müssen, müssen Sie die „mounts“-Option aktualisieren, um ein neues Quelle-Ziel-Paar für das persistente Volume zu erstellen. Weitere Informationen zu Bereitstellungen und Volumes finden Sie auf der Seite zum Verwenden von Volumes in der Docker-Dokumentation.

    {
    "HostConfig": {
        "CapAdd": [
            "SYS_PTRACE"
        ],
        "Binds": [
            "sqlvolume:/sqlvolume"
        ],
        "PortBindings": {
            "1433/tcp": [
                {
                    "HostPort": "1433"
                }
            ]
        },
        "Mounts": [
            {
                "Type": "volume",
                "Source": "sqlvolume",
                "Target": "/var/opt/mssql"
            }
        ]
    },
    "Env": [
        "MSSQL_AGENT_ENABLED=TRUE",
        "ClientTransportType=AMQP_TCP_Only",
        "PlanId=asde-developer-on-iot-edge"
    ]
}

    Wichtig

    Legen Sie die Umgebungsvariable PlanId basierend auf der installierten Edition fest.

    • Developer Edition - asde-developer-on-iot-edge
    • Premium Edition - asde-premium-on-iot-edge

    Wenn dieser Wert falsch festgelegt wird, wird der Azure SQL Edge-Container nicht gestartet.

    Warnung

    Wenn Sie das Modul erneut installieren, denken Sie daran, zuerst vorhandene Bindungen zu entfernen; andernfalls werden Ihre Umgebungsvariablen nicht aktualisiert.

  4. Wählen Sie auf der Seite IoT Edge-Modul hinzufügen die Option Hinzufügen aus.

  5. Wählen Sie auf der Seite Module für Gerät festlegen die Option Weiter: Routen> aus, wenn Sie Routen für Ihre Bereitstellung definieren müssen. Wählen Sie andernfalls Überprüfen und erstellen aus. Weitere Informationen zum Konfigurieren von Routen finden Sie unter Bereitstellen von Modulen und Einrichten von Routen in IoT Edge.

  6. Wählen Sie auf der Seite Module für Gerät festlegen die Option Erstellen aus.

Herstellen einer Verbindung mit Azure SQL Edge

In den folgenden Schritten wird das Azure SQL Edge-Befehlszeilentool sqlcmd im Container genutzt, um eine Verbindung mit Azure SQL Edge herzustellen.

Hinweis

SQL Server-Befehlszeilentools einschließlich sqlcmd sind innerhalb der ARM64-Version von Azure SQL Edge-Containern nicht verfügbar.

  1. Verwenden Sie den Befehl docker exec -it, um in Ihrem laufenden Container eine interaktive Bash-Shell zu starten. Im folgenden Beispiel steht AzureSQLEdge für den Namen, der vom Parameter Name Ihres IoT Edge-Moduls angegeben wird.

    sudo docker exec -it AzureSQLEdge "bash"

  2. Stellen Sie, sobald Sie sich im Container befinden, eine lokale Verbindung mit dem Tool sqlcmd her. Da sqlcmd nicht standardmäßig im Pfad enthalten ist, müssen Sie selbst den vollständigen Pfand angeben.

    /opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P "<YourNewStrong@Passw0rd>"

    Tipp

    Sie können das Kennwort in der Befehlszeile auslassen, damit Sie aufgefordert werden, es einzugeben.

  3. Wenn dies erfolgreich war, sollten zu einer sqlcmd Eingabeaufforderung: 1> gelangen.

Erstellen und Abfragen von Daten

Die folgenden Abschnitte führen Sie durch die Verwendung von sqlcmd und Transact-SQL, um eine neue Datenbank zu erstellen, Daten hinzuzufügen und eine Abfrage auszuführen.

Erstellen einer neuen Datenbank

Mit den folgenden Schritten wird eine neue Datenbank mit dem Namen TestDB erstellt.

  1. Fügen Sie aus der sqlcmd-Eingabeaufforderung den folgenden Transact-SQL-Befehl zur Erstellung einer Testdatenbank ein:

    CREATE DATABASE TestDB;
GO

  2. Schreiben Sie in der nächsten Zeile eine Abfrage, um den Namen all Ihrer Datenbanken auf Ihrem Server zurückzugeben:

    SELECT name from sys.databases;
GO

Einfügen von Daten

Erstellen Sie als Nächstes eine neue Tabelle mit dem Namen Inventory, und fügen Sie zwei neue Zeilen ein.

  1. Wechseln Sie den Kontext aus der sqlcmd-Eingabeaufforderung zur neuen TestDB-Datenbank:

    USE TestDB;

  2. Erstellen Sie eine neue Tabelle mit dem Namen Inventory:

    CREATE TABLE Inventory (id INT, name NVARCHAR(50), quantity INT)

  3. Fügen Sie Daten in die neue Tabelle ein:

    INSERT INTO Inventory
VALUES (1, 'banana', 150);

INSERT INTO Inventory
VALUES (2, 'orange', 154);

  4. Geben Sie GO ein, um die zuvor eingegebenen Befehle auszuführen:

    GO

Auswählen von Daten

Führen Sie nun eine Abfrage zum Zurückgeben von Daten aus der Inventory-Tabelle aus.

  1. Geben Sie aus der sqlcmd-Eingabeaufforderung eine Abfrage ein, die Reihen aus der Inventory-Tabelle zurückgibt, bei denen die Menge größer als 152 ist:

    SELECT * FROM Inventory WHERE quantity > 152;

  2. Führen Sie den folgenden Befehl aus:

    GO

Beenden der sqlcmd-Eingabeaufforderung

  1. Zum Beenden der sqlcmd-Sitzung, geben Sie QUIT ein:

    QUIT

  2. Geben Sie exit ein, um die interaktive Befehlszeile in Ihrem Container zu beenden. Der Container wird auch nach dem Beenden der interaktiven Bash-Shell weiter ausgeführt.

Herstellen einer Verbindung von außerhalb des Containers

Sie können über jedes externe Linux-, Windows- oder macOS-Tool, das SQL-Verbindungen unterstützt, eine Verbindung mit der SQL Edge-Instanz herstellen und SQL-Abfragen durchführen. Weitere Informationen zum Herstellen einer Verbindung mit einem SQL Edge-Container von außerhalb finden Sie unter Herstellen einer Verbindung mit und Abfragen von Azure SQL Edge (Vorschau).

In diesem Schnellstart haben Sie ein SQL Edge-Modul auf einem IoT Edge-Gerät bereitgestellt.

Zugehöriger Inhalt