Az Azure SQL Edge üzembe helyezése

Cikk
06/25/2024

Fontos

Az Azure SQL Edge már nem támogatja az ARM64 platformot.

Az Azure SQL Edge egy IoT- és Azure IoT Edge-környezetekhez optimalizált relációsadatbázis-motor. Lehetővé teszi, hogy nagy teljesítményű adattárolási és feldolgozási réteget hozzon létre az IoT-alkalmazások és -megoldások számára. Ez a rövid útmutató bemutatja, hogyan hozhat létre Azure SQL Edge-modult az Azure IoT Edge-en keresztül az Azure Portal használatával.

Mielőtt elkezdené

Ha nem rendelkezik Azure-előfizetéssel, hozzon létre egy ingyenes fiókot.
Jelentkezzen be az Azure Portalra.
Azure IoT Hub létrehozása.
Azure IoT Edge-eszköz létrehozása.

Feljegyzés

Az Azure Linux rendszerű virtuális gépek IoT Edge-eszközként való üzembe helyezéséhez tekintse meg ezt a rövid útmutatót.

Az Azure SQL Edge-modul üzembe helyezése az IoT Hub használatával

Az Azure SQL Edge üzembe helyezhető az Azure Portal moduljainak üzembe helyezési utasításaival. Az Azure SQL Edge rendszerképének URI-ja a következő mcr.microsoft.com/azure-sql-edge:latest: .

Az IoT Edge-modul hozzáadása lapon adja meg az IoT Edge-modul nevének, kép URI-jának, újraindítási szabályzatának és kívánt állapotának kívánt értékeit.

Az üzembe helyezni kívánt kiadástól függően használja a következő kép URI-t:
- Fejlesztői kiadás - mcr.microsoft.com/azure-sql-edge/developer
- Prémium kiadás - mcr.microsoft.com/azure-sql-edge/premium

Az IoT Edge-modul hozzáadása lap Környezeti változók szakaszában adja meg a környezeti változók kívánt értékeit. Az Azure SQL Edge környezeti változóinak teljes listáját lásd: Konfigurálás környezeti változók használatával.

Paraméter	Leírás
ACCEPT_EULA	Ennek az értéknek a `Y` beállítása a végfelhasználói licencszerződés elfogadására
MSSQL_SA_PASSWORD	Állítsa be az értéket úgy, hogy erős jelszót adjon meg az SQL Edge-rendszergazdai fiókhoz.
MSSQL_LCID	Állítsa be az értéket az SQL Edge-hez használni kívánt nyelvazonosító beállításához. Az 1036 például francia.
MSSQL_COLLATION	Állítsa be az értéket az SQL Edge alapértelmezett rendezési beállításához. Ez a beállítás felülbírálja a nyelvi azonosító (LCID) alapértelmezett leképezését a rendezéshez.

Az IoT Edge-modul hozzáadása lap Container Create Options szakaszában állítsa be a beállításokat igény szerint.
- Gazdagépport
  
  A megadott gazdagépport leképezése a tároló 1433-ai portjához (alapértelmezett SQL-port).
- Kötések és csatlakoztatások
  
  Ha több SQL Edge-modult kell üzembe helyeznie, győződjön meg arról, hogy frissíti a csatlakoztatási lehetőséget, hogy új forrás- és célpárot hozzon létre az állandó kötethez. További információ a csatlakoztatásokról és a kötetekről: Kötetek használata a Docker dokumentációjában.
```
{
    "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"
    ]
}
```
Fontos

Állítsa be a PlanId környezeti változót a telepített kiadás alapján.
- Fejlesztői kiadás - asde-developer-on-iot-edge
- Prémium kiadás - asde-premium-on-iot-edge
Ha ez az érték helytelenül van beállítva, az Azure SQL Edge-tároló nem indul el.
Figyelmeztetés

Ha újratelepíti a modult, először távolítsa el a meglévő kötéseket, ellenkező esetben a környezeti változók nem frissülnek.
Az IoT Edge-modul hozzáadása lapon válassza a Hozzáadás lehetőséget.
Az eszközlap Modulok beállítása lapján válassza a Tovább: Útvonalak > lehetőséget, ha útvonalakat kell meghatároznia az üzembe helyezéshez. Ellenkező esetben válassza a Véleményezés + Létrehozás lehetőséget. További információ az útvonalak konfigurálásáról: Modulok üzembe helyezése és útvonalak létrehozása az IoT Edge-ben.
Az eszközlap Modulok beállítása lapján válassza a Létrehozás lehetőséget.

Csatlakozás az Azure SQL Edge-hez

Az alábbi lépések az Azure SQL Edge parancssori eszközét( sqlcmd) használják a tárolón belül az Azure SQL Edge-hez való csatlakozáshoz.

Feljegyzés

Az SQL Server parancssori eszközei, köztük az sqlcmd, nem érhetők el az Azure SQL Edge-tárolók ARM64-es verziójában.

docker exec -it A parancs használatával elindíthat egy interaktív Bash-rendszerhéjat a futó tárolóban. Az alábbi példában AzureSQLEdge az IoT Edge-modul paramétere adja meg a Name nevet.
```
sudo docker exec -it AzureSQLEdge "bash"
```
Ha a tárolón belül van, csatlakozzon helyileg az sqlcmd eszközzel. Az sqlcmd alapértelmezés szerint nem szerepel az elérési úton, ezért meg kell adnia a teljes elérési utat.
```
/opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P "<YourNewStrong@Passw0rd>"
```
Tipp.

Kihagyhatja a jelszót a parancssorból, hogy a rendszer kérje a jelszó megadását.
Ha sikeres, a következő sqlcmd parancssort kell elérnie: 1>.

Adatok létrehozása és lekérdezése

Az alábbi szakaszok végigvezetik az sqlcmd és a Transact-SQL használatával egy új adatbázis létrehozására, adatok hozzáadására és lekérdezés futtatására.

Új adatbázis létrehozása

Az alábbi lépések egy új adatbázist TestDBhoznak létre.

Az sqlcmd parancssorból illessze be a következő Transact-SQL parancsot egy tesztadatbázis létrehozásához:
```
CREATE DATABASE TestDB;
GO
```
A következő sorban írjon egy lekérdezést a kiszolgáló összes adatbázisának nevének visszaadásához:
```
SELECT name from sys.databases;
GO
```

Adat beszúrása

Ezután hozzon létre egy új, úgynevezett Inventorytáblát, és szúrjon be két új sort.

Az sqlcmd parancssorból váltson a környezetre az új TestDB adatbázisra:
```
USE TestDB;
```

Új tábla létrehozása a következő néven Inventory:

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

Adatok beszúrása az új táblába:

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

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

Írja be GO az előző parancsok végrehajtását:
```
GO
```

Adatok kiválasztása

Most futtasson egy lekérdezést, amely adatokat ad vissza a Inventory táblából.

Az sqlcmd parancssorból adjon meg egy lekérdezést, amely a 152-nél nagyobb mennyiséget tartalmazó táblából ad Inventory vissza sorokat:
```
SELECT * FROM Inventory WHERE quantity > 152;
```
Hajtsa végre a következő parancsot:
```
GO
```

Kilépés az sqlcmd parancssorból

Az sqlcmd-munkamenet befejezéséhez írja be a következőt QUIT:
```
QUIT
```
Ha ki szeretne lépni az interaktív parancssorból a tárolóban, írja be a következőt exit: . A tároló az interaktív bash-rendszerhéjból való kilépés után is fut.

Csatlakozás a tárolón kívülről

Sql-lekérdezéseket csatlakoztathat és futtathat az Azure SQL Edge-példányon bármely külső Linux, Windows vagy macOS rendszerű eszközről, amely támogatja az SQL-kapcsolatokat. Az SQL Edge-tárolóhoz kívülről való csatlakozásról további információt az Azure SQL Edge csatlakoztatása és lekérdezése című témakörben talál.

Ebben a rövid útmutatóban üzembe helyezett egy SQL Edge-modult egy IoT Edge-eszközön.

Megosztás a következőn keresztül: