Dela via

Distribuera Azure SQL Edge

  • Artikel

Viktigt!

Azure SQL Edge dras tillbaka den 30 september 2025. Mer information och migreringsalternativ finns i meddelandet Om pensionering.

Kommentar

Azure SQL Edge stöder inte längre ARM64-plattformen.

Azure SQL Edge är en relationsdatabasmotor som är optimerad för IoT- och Azure IoT Edge-distributioner. Det ger funktioner för att skapa ett datalagrings- och bearbetningslager med höga prestanda för IoT-program och -lösningar. Den här snabbstarten visar hur du kommer igång med att skapa en Azure SQL Edge-modul via Azure IoT Edge med hjälp av Azure Portal.

Innan du börjar

Kommentar

Information om hur du distribuerar en virtuell Azure Linux-dator som en IoT Edge-enhet finns i den här snabbstartsguiden.

Distribuera Azure SQL Edge-modul med IoT Hub

Azure SQL Edge kan distribueras med hjälp av instruktioner från Distribuera moduler från Azure Portal. Avbildnings-URI:n för Azure SQL Edge är mcr.microsoft.com/azure-sql-edge:latest.

  1. På sidan Lägg till IoT Edge-modul anger du önskade värden för IoT Edge-modulens namn, bild-URI, omstartsprincip och önskad status.

    Använd följande avbildnings-URI beroende på vilken utgåva du vill distribuera:

    • Utvecklarutgåva - mcr.microsoft.com/azure-sql-edge/developer
    • Premium-utgåva - mcr.microsoft.com/azure-sql-edge/premium

  2. I avsnittet Miljövariabler på sidan Lägg till IoT Edge-modul anger du önskade värden för miljövariablerna. En fullständig lista över Azure SQL Edge-miljövariabler finns i Konfigurera med hjälp av miljövariabler.

    Parameter Description
    ACCEPT_EULA Ange det här värdet till Y för att godkänna licensavtalet för slutanvändare
    MSSQL_SA_PASSWORD Ange värdet för att ange ett starkt lösenord för SQL Edge-administratörskontot.
    MSSQL_LCID Ange värdet för att ange önskat språk-ID som ska användas för SQL Edge. Till exempel är 1036 franska.
    MSSQL_COLLATION Ange värdet för att ange standardsortering för SQL Edge. Den här inställningen åsidosätter standardmappningen av språk-ID (LCID) till sortering.

  3. I avsnittet Alternativ för att skapa container på sidan Lägg till IoT Edge-modul anger du alternativen efter behov.

    • Värdport

      Mappa den angivna värdporten till port 1433 (standard-SQL-port) i containern.

    • Bindningar och monteringar

      Om du behöver distribuera fler än en SQL Edge-modul kontrollerar du att du uppdaterar monteringsalternativet för att skapa ett nytt käll- och målpar för den beständiga volymen. Mer information om monteringar och volymer finns i Använda volymer i Docker-dokumentationen.

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

    Viktigt!

    PlanId Ange miljövariabeln baserat på den utgåva som är installerad.

    • Utvecklarutgåva - asde-developer-on-iot-edge
    • Premium-utgåva - asde-premium-on-iot-edge

    Om det här värdet har angetts felaktigt startar inte Azure SQL Edge-containern.

    Varning

    Om du installerar om modulen måste du först ta bort befintliga bindningar, annars uppdateras inte dina miljövariabler.

  4. På sidan Lägg till IoT Edge-modul väljer du Lägg till.

  5. På sidan Ange moduler på enheten väljer du Nästa: Vägar > om du behöver definiera vägar för distributionen. Annars väljer du Granska + Skapa. Mer information om hur du konfigurerar vägar finns i Distribuera moduler och upprätta vägar i IoT Edge.

  6. På sidan Ange moduler på enheten väljer du Skapa.

Ansluta till Azure SQL Edge

Följande steg använder kommandoradsverktyget Azure SQL Edge, sqlcmd, i containern för att ansluta till Azure SQL Edge.

Kommentar

SQL Server-kommandoradsverktyg, inklusive sqlcmd, är inte tillgängliga i ARM64-versionen av Azure SQL Edge-containrar.

  1. docker exec -it Använd kommandot för att starta ett interaktivt bash-gränssnitt i containern som körs. I följande exempel AzureSQLEdge är namnet som anges av parametern för Name din IoT Edge-modul.

    sudo docker exec -it AzureSQLEdge "bash"

  2. När du är inne i containern ansluter du lokalt med sqlcmd-verktyget . sqlcmd finns inte i sökvägen som standard, så du måste ange den fullständiga sökvägen.

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

    Dricks

    Du kan utelämna lösenordet på kommandoraden för att uppmanas att ange det.

  3. Om det lyckas bör du komma till en sqlcmd-kommandotolk : 1>.

Skapa och fråga efter data

Följande avsnitt beskriver hur du använder sqlcmd och Transact-SQL för att skapa en ny databas, lägga till data och köra en fråga.

Skapa en ny databas

Följande steg skapar en ny databas med namnet TestDB.

  1. Från kommandotolken sqlcmd klistrar du in följande Transact-SQL-kommando för att skapa en testdatabas:

    CREATE DATABASE TestDB;
GO

  2. På nästa rad skriver du en fråga för att returnera namnet på alla databaser på servern:

    SELECT name from sys.databases;
GO

Infoga data

Skapa sedan en ny tabell med namnet Inventoryoch infoga två nya rader.

  1. Växla kontext till den nya TestDB databasen från kommandotolken för sqlcmd:

    USE TestDB;

  2. Skapa en ny tabell med namnet Inventory:

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

  3. Infoga data i den nya tabellen:

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

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

  4. Skriv GO för att köra föregående kommandon:

    GO

Välj data

Kör nu en fråga för att returnera data från Inventory tabellen.

  1. Från kommandotolken sqlcmd anger du en fråga som returnerar rader från Inventory tabellen där antalet är större än 152:

    SELECT * FROM Inventory WHERE quantity > 152;

  2. Kör kommandot:

    GO

Avsluta kommandotolken för sqlcmd

  1. Om du vill avsluta sqlcmd-sessionen skriver du QUIT:

    QUIT

  2. Om du vill avsluta den interaktiva kommandotolken i containern skriver du exit. Containern fortsätter att köras när du har avslutat det interaktiva bash-gränssnittet.

Ansluta utanför containern

Du kan ansluta och köra SQL-frågor mot din Azure SQL Edge-instans från alla externa Linux-, Windows- eller macOS-verktyg som stöder SQL-anslutningar. Mer information om hur du ansluter till en SQL Edge-container utifrån finns i Ansluta och fråga Azure SQL Edge.

I den här snabbstarten distribuerade du en SQL Edge-modul på en IoT Edge-enhet.

Relaterat innehåll