Azure SQL Edge implementeren

Belangrijk

Azure SQL Edge wordt vanaf 30 september 2025 buiten gebruik gesteld. Zie de pensioenmelding voor meer informatie en migratieopties.

Opmerking

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

Als u geen Azure-abonnement hebt, maakt u een gratis account.
Meld u aan bij het Azure-portaal.
Een Azure IoT Hub maken.
Maak een Azure IoT Edge-apparaat.

Opmerking

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.

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

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.

Kenmerk	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.

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.
Selecteer Toevoegen op de pagina IoT Edge-module toevoegen.
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.
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.

Opmerking

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

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

U kunt het wachtwoord op de opdrachtregel weglaten om te worden gevraagd het in te voeren.
Als dit lukt, gaat u naar een sqlcmd opdrachtprompt: 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.

Plak in de opdrachtprompt sqlcmd de volgende Transact-SQL opdracht om een testdatabase te maken:
```
CREATE DATABASE TestDB;
GO
```
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.

Schakel vanuit de opdrachtprompt sqlcmd de context over naar de nieuwe TestDB-database.
```
USE TestDB;
```

Maak een nieuwe tabel met de naam Inventory:

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

Gegevens invoegen in de nieuwe tabel:

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

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

Typ GO om de vorige opdrachten uit te voeren:
```
GO
```

Gegevens selecteren

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

Voer vanuit de opdrachtprompt sqlcmd een query in waarmee rijen worden geretourneerd uit de Inventory tabel waarin de hoeveelheid groter is dan 152:
```
SELECT * FROM Inventory WHERE quantity > 152;
```
Voer de opdracht uit:
```
GO
```

De sqlcmd-opdrachtprompt afsluiten

Als u uw sqlcmd-sessie wilt beëindigen, typt u QUIT:
```
QUIT
```
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.

Last updated on 2024-09-21

Delen via

Azure SQL Edge implementeren

Voordat u begint

Azure SQL Edge-module implementeren met IoT Hub

Verbinding maken met Azure SQL Edge

Gegevens maken en er query's op uitvoeren

Een nieuwe database maken

Gegevens invoegen

Gegevens selecteren

De sqlcmd-opdrachtprompt afsluiten

Verbinding maken van buiten de container

Verwante inhoud

Aanvullende resources