Delen via

Azure SQL Edge implementeren

  • Artikel

Belangrijk

Azure SQL Edge wordt op 30 september 2025 buiten gebruik gesteld. Zie de kennisgeving buitengebruikstelling voor meer informatie en migratieopties.

Notitie

Azure SQL Edge biedt geen ondersteuning meer voor het ARM64-platform.

Azure SQL Edge is een relationele database-engine die is geoptimaliseerd voor IoT- en Azure IoT Edge-implementaties. Het biedt mogelijkheden om een hoogwaardige gegevensopslag- en verwerkingslaag te maken voor IoT-toepassingen en -oplossingen. In deze quickstart leert u hoe u aan de slag gaat met het maken van een Azure SQL Edge-module via Azure IoT Edge met behulp van Azure Portal.

Voordat u begint

Notitie

Raadpleeg deze quickstart voor het implementeren van een Virtuele Linux-machine in Azure als een IoT Edge-apparaat.

Azure SQL Edge-module implementeren met IoT Hub

Azure SQL Edge kan worden geïmplementeerd met behulp van instructies uit De modules implementeren vanuit de Azure-portal. De installatiekopieën-URI voor Azure SQL Edge is mcr.microsoft.com/azure-sql-edge:latest.

  1. Geef op de pagina IoT Edge-module toevoegen de gewenste waarden op voor de naam van de IoT Edge-module, afbeeldings-URI, beleid voor opnieuw opstarten en gewenste status.

    Gebruik de volgende afbeeldings-URI, afhankelijk van de editie die u wilt implementeren:

    • Ontwikkelaarseditie - mcr.microsoft.com/azure-sql-edge/developer
    • Premium-editie - mcr.microsoft.com/azure-sql-edge/premium

  2. Geef in de sectie Omgevingsvariabelen van de pagina IoT Edge-module toevoegen de gewenste waarden op voor de omgevingsvariabelen. Zie Configureren met behulp van omgevingsvariabelen in Azure SQL Edge voor een volledige lijst met omgevingsvariabelen in Azure SQL Edge.

    Parameter Description
    ACCEPT_EULA Stel deze waarde in om de licentieovereenkomst voor eindgebruikers te Y accepteren
    MSSQL_SA_PASSWORD Stel de waarde in om een sterk wachtwoord op te geven voor het SQL Edge-beheerdersaccount.
    MSSQL_LCID Stel de waarde in om de gewenste taal-id in te stellen voor SQL Edge. 1036 is bijvoorbeeld Frans.
    MSSQL_COLLATION Stel de waarde in om de standaardsortering voor SQL Edge in te stellen. Met deze instelling wordt de standaardtoewijzing van taal-id (LCID) voor sortering overschreven.

  3. Stel in de sectie Opties voor container maken van de pagina IoT Edge-module toevoegen de opties in op basis van de vereiste.

    • Hostpoort

      Wijs de opgegeven hostpoort toe aan poort 1433 (standaard SQL-poort) in de container.

    • Bindingen en koppelingen

      Als u meer dan één SQL Edge-module moet implementeren, moet u ervoor zorgen dat u de koppelingsoptie bijwerkt om een nieuw bron- en doelpaar te maken voor het permanente volume. Zie de documentatie over volumes in Docker gebruiken voor meer informatie over koppelingen en volumes .

    {
    "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"
    ]
}

    Belangrijk

    Stel de PlanId omgevingsvariabele in op basis van de geïnstalleerde editie.

    • Ontwikkelaarseditie - asde-developer-on-iot-edge
    • Premium-editie - asde-premium-on-iot-edge

    Als deze waarde onjuist is ingesteld, kan de Azure SQL Edge-container niet worden gestart.

    Waarschuwing

    Als u de module opnieuw installeert, moet u eerst bestaande bindingen verwijderen, anders worden uw omgevingsvariabelen niet bijgewerkt.

  4. Selecteer Toevoegen op de pagina IoT Edge-module toevoegen.

  5. Selecteer volgende op de pagina Modules instellen op het apparaat: Routes > als u routes voor uw implementatie wilt definiëren. Selecteer anders Beoordelen en maken. Zie Modules implementeren en routes instellen in IoT Edge voor meer informatie over het configureren van routes.

  6. Selecteer Maken op de pagina Modules instellen op het apparaat.

Verbinding maken met Azure SQL Edge

In de volgende stappen wordt het Azure SQL Edge-opdrachtregelprogramma, sqlcmd, in de container gebruikt om verbinding te maken met Azure SQL Edge.

Notitie

SQL Server-opdrachtregelprogramma's, waaronder sqlcmd, zijn niet beschikbaar in de ARM64-versie van Azure SQL Edge-containers.

  1. Gebruik de opdracht docker exec -it voor het starten van een interactieve bash-shell in de container die wordt uitgevoerd. In het volgende voorbeeld AzureSQLEdge wordt de naam opgegeven door de Name parameter van uw IoT Edge-module.

    sudo docker exec -it AzureSQLEdge "bash"

  2. Maak in de container lokaal verbinding met het hulpprogramma sqlcmd . sqlcmd bevindt zich niet standaard in het pad, dus u moet het volledige pad opgeven.

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

    Tip

    U kunt het wachtwoord op de opdrachtregel weglaten om te worden gevraagd het in te voeren.

  3. Als dit is gelukt, krijgt u een opdrachtprompt voor sqlcmd: 1>.

Gegevens maken en er query's op uitvoeren

In de volgende secties leert u hoe u sqlcmd en Transact-SQL gebruikt om een nieuwe database te maken, gegevens toe te voegen en een query uit te voeren.

Een nieuwe database maken

Met de volgende stappen maakt u een nieuwe database met de naam TestDB.

  1. Plak de volgende Transact-SQL-opdracht van de opdrachtprompt van sqlcmd om een testdatabase te maken:

    CREATE DATABASE TestDB;
GO

  2. Schrijf op de volgende regel een query om de naam van alle databases op uw server te retourneren:

    SELECT name from sys.databases;
GO

Gegevens invoegen

Maak vervolgens een nieuwe tabel met de naam Inventoryen voeg twee nieuwe rijen in.

  1. Ga vanuit de opdrachtprompt van sqlcmd naar de nieuwe TestDB-database:

    USE TestDB;

  2. Maak een nieuwe tabel met de naam Inventory:

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

  3. Voeg gegevens in de nieuwe tabel in:

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

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

  4. Typ GO om de vorige opdrachten uit te voeren:

    GO

Gegevens selecteren

Voer nu een query uit om gegevens op te halen uit de tabel Inventory.

  1. Voer vanuit de opdrachtprompt van sqlcmd een query in die rijen uit de tabel Inventory retourneert, waarbij de hoeveelheid groter is dan 152:

    SELECT * FROM Inventory WHERE quantity > 152;

  2. Voer de opdracht uit:

    GO

De sqlcmd-opdrachtprompt afsluiten

  1. Als u uw sqlcmd-sessie wilt beëindigen, typt u QUIT:

    QUIT

  2. Als u de interactieve opdrachtprompt in de container wilt afsluiten, typt u exit. Uw container blijft actief nadat u de interactieve bash-shell hebt afgesloten.

Verbinding maken van buiten de container

U kunt SQL-query's verbinden en uitvoeren op uw Azure SQL Edge-exemplaar vanuit elk extern Linux-, Windows- of macOS-hulpprogramma dat ONDERSTEUNING biedt voor SQL-verbindingen. Zie Verbinding maken en query's uitvoeren op Azure SQL Edge voor meer informatie over het maken van verbinding met een SQL Edge-container van buiten.

In deze quickstart hebt u een SQL Edge-module geïmplementeerd op een IoT Edge-apparaat.

Gerelateerde inhoud