Dela via

Distribuera Azure SQL Edge

Viktigt!

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

Anmärkning

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

Anmärkning

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.

Anmärkning

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>"

    Tips/Råd

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

  3. Om det blir framgångsrikt ska 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. Från kommandotolken sqlcmd växlar du kontexten till den nya TestDB databasen:

    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 tabellen Inventory.

  1. Från kommandotolken sqlcmd anger du en fråga som returnerar rader från tabellen Inventory där kvantiteten ä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 din sqlcmd--session 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