Nasazení Azure SQL Edge

Článek
10/24/2023

Důležité

Azure SQL Edge už nepodporuje platformu ARM64.

Azure SQL Edge je relační databázový stroj optimalizovaný pro nasazení IoT a Azure IoT Edge. Poskytuje možnosti vytvoření vysoce výkonné vrstvy úložiště a zpracování dat pro aplikace a řešení IoT. V tomto rychlém startu se dozvíte, jak začít vytvářet modul Azure SQL Edge prostřednictvím Azure IoT Edge pomocí webu Azure Portal.

Než začnete

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet.
Přihlaste se k portálu Azure.
Vytvořte Azure IoT Hub.
Vytvořte zařízení Azure IoT Edge.

Poznámka:

Pokud chcete nasadit virtuální počítač Azure s Linuxem jako zařízení IoT Edge, přečtěte si tuto příručku pro rychlý start.

Nasazení modulu SQL Edge z Azure Marketplace

Azure Marketplace je online marketplace aplikací a služeb, kde můžete procházet širokou škálu podnikových aplikací a řešení, která jsou certifikovaná a optimalizovaná pro provoz v Azure, včetně modulů IoT Edge. Azure SQL Edge je možné nasadit na hraniční zařízení prostřednictvím marketplace.

Najděte modul Azure SQL Edge na Azure Marketplace.
Vyberte plán softwaru, který nejlépe odpovídá vašim požadavkům, a vyberte Vytvořit.

Na stránce Cílová zařízení pro modul IoT Edge zadejte následující podrobnosti a pak vyberte Vytvořit.

Pole	Popis
Předplatné	Předplatné Azure, ve kterém se služba IoT Hub vytvořila
IoT Hub	Název ioT Hubu, kde je zařízení IoT Edge zaregistrované, a pak vyberte možnost Nasadit do zařízení.
Název zařízení IoT Edge	Název zařízení IoT Edge, ve kterém se nasadí SQL Edge

Na stránce Nastavit moduly na zařízení: vyberte modul Azure SQL Edge v části Moduly IoT Edge. Výchozí název modulu je nastavený na AzureSQLEdge.
V části Modul Nastavení podokna Aktualizovat modul IoT Edge zadejte požadované hodnoty pro název modulu IoT Edge, zásady restartování a požadovaný stav.

Důležité

Nezměníte ani neaktualizujete nastavení identifikátoru URI obrázku v modulu.

V části Proměnné prostředí podokna Aktualizovat modul IoT Edge zadejte požadované hodnoty pro proměnné prostředí. Úplný seznam proměnných prostředí Azure SQL Edge najdete v tématu Konfigurace pomocí proměnných prostředí. Pro modul jsou definovány následující výchozí proměnné prostředí.

Parametr	Popis
MSSQL_SA_PASSWORD	Změňte výchozí hodnotu tak, aby zadala silné heslo pro účet správce SQL Edge.
MSSQL_LCID	Změňte výchozí hodnotu a nastavte ID požadovaného jazyka tak, aby se používalo pro SQL Edge. Například 1036 je francouzština.
MSSQL_COLLATION	Změňte výchozí hodnotu tak, aby se nastavila výchozí kolace pro SQL Edge. Toto nastavení přepíše výchozí mapování ID jazyka (LCID) na kolaci.

Důležité

Neměňte ani neaktualizujete proměnnou ACCEPT_EULA prostředí pro modul.

V části Možnosti vytvoření kontejneru v podokně Aktualizovat modul IoT Edge aktualizujte následující možnosti podle požadavku.
- Port hostitele
  
  Namapujte zadaný port hostitele na port 1433 (výchozí port SQL) v kontejneru.
- Vazby a připojení
  
  Pokud potřebujete nasadit více než jeden modul SQL Edge, nezapomeňte aktualizovat možnost připojení a vytvořit nový zdrojový a cílový pár pro trvalý svazek. Další informace o připojeních a svazcích najdete v dokumentaci k Dockeru pomocí svazků .
```
{
    "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"
    ]
}
```
Důležité

Neměňte proměnnou PlanId prostředí definovanou v nastavení vytvoření konfigurace. Pokud se tato hodnota změní, kontejner Azure SQL Edge se nespustí.

Upozorňující

Pokud modul přeinstalujete, nezapomeňte nejprve odebrat všechny existující vazby, jinak se proměnné prostředí nebudou aktualizovat.
V podokně Aktualizovat modul IoT Edge vyberte Aktualizovat.
Na stránce Nastavit moduly na zařízení vyberte Další: Trasy>, pokud potřebujete definovat trasy pro vaše nasazení. V opačném případě vyberte Zkontrolovat a vytvořit. Další informace o konfiguraci tras najdete v tématu Nasazení modulů a navázání tras v IoT Edge.
Na stránce Nastavit moduly na zařízení vyberte Vytvořit.

Připojení do Azure SQL Edge

Následující kroky používají nástroj příkazového řádku Azure SQL Edge sqlcmd uvnitř kontejneru pro připojení k Azure SQL Edge.

Poznámka:

Nástroje příkazového řádku SQL Serveru, včetně sqlcmd, nejsou dostupné ve verzi ARM64 kontejnerů Azure SQL Edge.

docker exec -it Pomocí příkazu spusťte interaktivní prostředí Bash uvnitř spuštěného kontejneru. V následujícím příkladu AzureSQLEdge je název určený parametrem Name vašeho modulu IoT Edge.
```
sudo docker exec -it AzureSQLEdge "bash"
```
Jakmile v kontejneru, připojte se místně pomocí nástroje sqlcmd . Sqlcmd není ve výchozím nastavení v cestě, takže musíte zadat úplnou cestu.
```
/opt/mssql-tools/bin/sqlcmd -S localhost -U SA -P "<YourNewStrong@Passw0rd>"
```
Tip

Heslo na příkazovém řádku můžete vynechat, aby se zobrazila výzva k jeho zadání.
V případě úspěchu byste se měli dostat k příkazovému řádku sqlcmd : 1>.

Vytvoření a dotazování dat

Následující části vás provedou použitím sqlcmd a Transact-SQL k vytvoření nové databáze, přidání dat a spuštění dotazu.

Vytvoření nové databáze

Následující kroky vytvoří novou databázi s názvem TestDB.

Z příkazového řádku sqlcmd vložte následující příkaz Transact-SQL k vytvoření testovací databáze:
```
CREATE DATABASE TestDB;
GO
```
Na dalším řádku napište dotaz, který vrátí název všech databází na vašem serveru:
```
SELECT name from sys.databases;
GO
```

Vložení dat

Dále vytvořte novou tabulku s názvem Inventorya vložte dva nové řádky.

Z příkazového řádku sqlcmd přepněte kontext na novou TestDB databázi:
```
USE TestDB;
```

Vytvořte novou tabulku s názvem Inventory:

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

Vložte data do nové tabulky:

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

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

Zadejte GO , aby se spustily předchozí příkazy:
```
GO
```

Výběr dat

Teď spusťte dotaz, který vrátí data z Inventory tabulky.

Z příkazového řádku sqlcmd zadejte dotaz, který vrátí řádky z Inventory tabulky, kde je množství větší než 152:
```
SELECT * FROM Inventory WHERE quantity > 152;
```
Spusťte příkaz:
```
GO
```

Ukončete příkazový řádek sqlcmd.

Chcete-li ukončit relaci sqlcmd , zadejte QUIT:
```
QUIT
```
Chcete-li ukončit interaktivní příkazový řádek v kontejneru, zadejte exit. Kontejner se bude dál spouštět po ukončení interaktivního prostředí Bash.

Připojení mimo kontejner

Dotazy SQL můžete připojit a spouštět na instanci Azure SQL Edge z libovolného externího nástroje pro Linux, Windows nebo macOS, který podporuje připojení SQL. Další informace o připojení k externímu kontejneru SQL Edge najdete v tématu Připojení a dotazování Azure SQL Edge.

V tomto rychlém startu jste nasadili modul SQL Edge na zařízení IoT Edge.