Aracılığıyla paylaş

Uç Cihazlar için Azure SQL'i dağıtma

  • Makale

Önemli

Azure SQL Edge 30 Eylül 2025'te kullanımdan kaldırılacaktır. Daha fazla bilgi ve geçiş seçenekleri için Bkz . Kullanımdan kaldırma bildirimi.

Not

Azure SQL Edge artık ARM64 platformunu desteklememektedir.

Azure SQL Edge, IoT ve Azure IoT Edge dağıtımları için iyileştirilmiş bir ilişkisel veritabanı altyapısıdır. IoT uygulamaları ve çözümleri için yüksek performanslı bir veri depolama ve işleme katmanı oluşturma özellikleri sağlar. Bu hızlı başlangıçta, Azure portalını kullanarak Azure IoT Edge aracılığıyla Azure SQL Edge modülü oluşturmaya nasıl başladığınız gösterilmektedir.

Başlamadan önce

Not

Azure Linux VM'sini IoT Edge cihazı olarak dağıtmak için bu hızlı başlangıç kılavuzuna bakın.

IoT Hub kullanarak Azure SQL Edge Modülü dağıtma

Azure SQL Edge, Modülleri Azure portalından dağıtma yönergeleri kullanılarak dağıtılabilir. Azure SQL Edge için görüntü URI'si şeklindedir mcr.microsoft.com/azure-sql-edge:latest.

  1. IoT Edge Modülü Ekle sayfasında IoT Edge Modülü Adı, Görüntü URI'si, Yeniden Başlatma İlkesi ve İstenen Durum için istenen değerleri belirtin.

    Dağıtmak istediğiniz sürüme bağlı olarak aşağıdaki görüntü URI'sini kullanın:

    • Geliştirici sürümü - mcr.microsoft.com/azure-sql-edge/developer
    • Premium sürüm - mcr.microsoft.com/azure-sql-edge/premium

  2. IoT Edge Modülü Ekle sayfasının Ortam Değişkenleri bölümünde ortam değişkenleri için istenen değerleri belirtin. Azure SQL Edge ortam değişkenlerinin tam listesi için bkz . Ortam değişkenlerini kullanarak yapılandırma.

    Parametre Açıklama
    ACCEPT_EULA Son Kullanıcı Lisans Sözleşmesi'ni kabul etmek için Y bu değeri olarak ayarlayın
    MSSQL_SA_PASSWORD SQL Edge yönetici hesabı için güçlü bir parola belirtmek için değerini ayarlayın.
    MSSQL_LCID SQL Edge için kullanılacak istenen dil kimliğini ayarlamak için değerini ayarlayın. Örneğin, 1036 Fransızcadır.
    MSSQL_COLLATION SQL Edge için varsayılan harmanlamayı ayarlamak için değerini ayarlayın. Bu ayar, dil kimliğinin (LCID) harmanlamayla varsayılan eşlemesini geçersiz kılar.

  3. IoT Edge Modülü Ekle sayfasının Kapsayıcı Oluşturma Seçenekleri bölümünde, seçenekleri gereksinime göre ayarlayın.

    • Konak Bağlantı Noktası

      Belirtilen konak bağlantı noktasını kapsayıcıdaki 1433 numaralı bağlantı noktasına (varsayılan SQL bağlantı noktası) eşleyin.

    • Bağlamalar ve Bağlamalar

      Birden fazla SQL Edge modülü dağıtmanız gerekiyorsa, kalıcı birim için yeni bir kaynak ve hedef çifti oluşturmak üzere bağlamalar seçeneğini güncelleştirdiğinizden emin olun. Bağlamalar ve birim hakkında daha fazla bilgi için Docker'da birimleri kullanma belgelerine bakın.

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

    Önemli

    Ortam değişkenini PlanId yüklü sürüme göre ayarlayın.

    • Geliştirici sürümü - asde-developer-on-iot-edge
    • Premium sürüm - asde-premium-on-iot-edge

    Bu değer yanlış ayarlanırsa Azure SQL Edge kapsayıcısı başlatılamaz.

    Uyarı

    Modülü yeniden yüklerseniz, önce mevcut bağlamaları kaldırmayı unutmayın; aksi takdirde ortam değişkenleriniz güncelleştirilmez.

  4. IoT Edge Modülü Ekle sayfasında Ekle'yi seçin.

  5. Cihazdaki modülleri ayarla sayfasında İleri: Dağıtımınız için yollar tanımlamanız gerekiyorsa Yollar'ı > seçin. Aksi takdirde Gözden Geçir + Oluştur'u seçin. Yolları yapılandırma hakkında daha fazla bilgi için bkz . IoT Edge'de modülleri dağıtma ve yolları oluşturma.

  6. Cihazdaki modülleri ayarla sayfasında Oluştur'u seçin.

Azure SQL Edge'e bağlanma

Aşağıdaki adımlarda, Azure SQL Edge'e bağlanmak için kapsayıcının içindeki sqlcmd azure SQL Edge komut satırı aracı kullanılır.

Not

sqlcmd de dahil olmak üzere SQL Server komut satırı araçları, Azure SQL Edge kapsayıcılarının ARM64 sürümünde kullanılamaz.

  1. docker exec -it Komutunu kullanarak çalışan kapsayıcınızın içinde etkileşimli bir bash kabuğu başlatın. Aşağıdaki örnekte, AzureSQLEdge IoT Edge Modülünüzün Name parametresi tarafından belirtilen addır.

    sudo docker exec -it AzureSQLEdge "bash"

  2. Kapsayıcının içine girdikten sonra sqlcmd aracıyla yerel olarak bağlanın. sqlcmd varsayılan olarak yolda olmadığından tam yolu belirtmeniz gerekir.

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

    İpucu

    Girmeniz istenecek komut satırında parolayı atlayabilirsiniz.

  3. Başarılı olursa, bir sqlcmd komut istemine ulaşmalısınız: 1>.

Veri oluşturma ve sorgulama

Aşağıdaki bölümlerde sqlcmd ve Transact-SQL kullanarak yeni bir veritabanı oluşturma, veri ekleme ve sorgu çalıştırma adımları gösterilir.

Yeni veritabanı oluşturma

Aşağıdaki adımlar adlı TestDByeni bir veritabanı oluşturur.

  1. sqlcmd komut isteminden aşağıdaki Transact-SQL komutunu yapıştırarak bir test veritabanı oluşturun:

    CREATE DATABASE TestDB;
GO

  2. Sonraki satırda, sunucunuzdaki tüm veritabanlarının adını döndürmek için bir sorgu yazın:

    SELECT name from sys.databases;
GO

Veri ekleme

Ardından adlı Inventoryyeni bir tablo oluşturun ve iki yeni satır ekleyin.

  1. sqlcmd komut isteminden bağlamı yeni TestDB veritabanına geçin:

    USE TestDB;

  2. adlı Inventoryyeni bir tablo oluşturun:

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

  3. Yeni tabloya veri ekleme:

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

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

  4. Önceki komutları yürütmek için yazın GO :

    GO

Verileri seçme

Şimdi tablodan Inventory veri döndürmek için bir sorgu çalıştırın.

  1. sqlcmd komut isteminden, tablodan miktarın 152'den Inventory büyük olduğu satırları döndüren bir sorgu girin:

    SELECT * FROM Inventory WHERE quantity > 152;

  2. Komutunu yürüt:

    GO

sqlcmd komut isteminden çıkma

  1. sqlcmd oturumunuzu sonlandırmak için yazın QUIT:

    QUIT

  2. Kapsayıcınızdaki etkileşimli komut isteminden çıkmak için yazın exit. Etkileşimli bash kabuğundan çıktıktan sonra kapsayıcınız çalışmaya devam eder.

Kapsayıcının dışından bağlanma

SQL bağlantılarını destekleyen herhangi bir dış Linux, Windows veya macOS aracından Azure SQL Edge örneğiniz üzerinde SQL sorguları bağlayabilir ve çalıştırabilirsiniz. Dışarıdan bir SQL Edge kapsayıcısına bağlanma hakkında daha fazla bilgi için bkz . Azure SQL Edge'e Bağlanma ve Sorgulama.

Bu hızlı başlangıçta, IoT Edge cihazına bir SQL Edge Modülü dağıttınız.

İlgili içerik