İngilizce dilinde oku

Aracılığıyla paylaş

Azure AI Search'ten SQL yönetilen örneği için paylaşılan özel bağlantı oluşturma

  • Makale

Bu makalede, Azure AI Search'te bir sanal ağ içinde çalışan SQL yönetilen örneğine özel bağlantı için dizin oluşturucu yapılandırma işlemi açıklanmaktadır. Özel bağlantı, paylaşılan bir özel bağlantı ve Azure Özel Bağlantı üzerinden yapılır.

Yönetilen örneğe özel bir bağlantıda, örneğin tam etki alanı adı (FQDN) DNS Bölgesini içermelidir. Şu anda yalnızca Azure AI Arama Yönetimi REST API'sinde DNS bölgesi belirtimini kabul etmek için bir dnsZonePrefix parametre sağlanır.

Yönetim REST API'sini doğrudan çağırabilirsiniz ancak bir komut satırından Yönetim REST API çağrıları göndermek için Azure CLI az rest modülünü kullanmak daha kolaydır. Bu makalede, özel bağlantıyı ayarlamak için REST ile Azure CLI kullanılır.

Not

Bu makale, özellikleri almak ve adımları onaylamak için Azure portalına başvurur. Ancak, SQL Yönetilen Örneği için paylaşılan özel bağlantıyı oluştururken REST API kullandığınızdan emin olun. Ağ sekmesi bir seçenek olarak listelese Microsoft.Sql/managedInstances de, Azure portalı şu anda SQL Yönetilen Örneği tarafından kullanılan genişletilmiş URL biçimini desteklemez.

Önkoşullar

  • Azure CLI

  • Azure AI Search, Temel veya üzeri. Yapay zeka zenginleştirme ve beceri kümelerini kullanıyorsanız Standart 2 (S2) veya üzerini kullanın. Ayrıntılar için bkz . Hizmet sınırları .

  • Azure SQL Yönetilen Örneği, sanal ağda çalışacak şekilde yapılandırılır.

  • Hem Azure AI Search hem de SQL Yönetilen Örneği üzerinde en az Katkıda Bulunan izinlerine sahip olmanız gerekir.

  • Azure SQL Yönetilen Örneği bağlantı dizesi. Yönetilen kimlik şu anda paylaşılan özel bağlantıyla desteklenmiyor. bağlantı dizesi bir kullanıcı adı ve parola içermelidir.

Not

Paylaşılan özel bağlantılar Azure Özel Bağlantı fiyatlandırma aracılığıyla faturalandırılabilir ve ücretler kullanıma göre faturalandırılır.

1 - Bağlantı bilgilerini alma

Bu bölümde, ana bilgisayar adından DNS bölgesini ve bir bağlantı dizesi alın.

  1. Azure portalında SQL yönetilen örneği nesnesini bulun.

  2. Genel Bakış sekmesinde Konak özelliğini bulun. Sonraki adım için FQDN'nin DNS bölgesi bölümünü kopyalayın. DNS bölgesi, SQL Yönetilen Örneği etki alanı adının bir parçasıdır. Örneğin, SQL Yönetilen Örneği FQDN'sinin olması my-sql-managed-instance.a1b22c333d44.database.windows.netdurumunda DNS bölgesi olura1b22c333d44.

  3. Bağlantı dizeleri sekmesinde, sonraki bir adım için ADO.NET bağlantı dizesi kopyalayın. Özel bağlantıyı test ederken veri kaynağı bağlantısı için gereklidir.

Bağlantı özellikleri hakkında daha fazla bilgi için bkz. Azure SQL Yönetilen Örneği oluşturma.

2 - İsteğin gövdesini oluşturma

  1. Metin düzenleyicisi kullanarak paylaşılan özel bağlantı için JSON oluşturun.

    {
    "name": "{{shared-private-link-name}}",
    "properties": {
        "privateLinkResourceId": "/subscriptions/{{target-resource-subscription-ID}}/resourceGroups/{{target-resource-rg}}/providers/Microsoft.Sql/managedInstances/{{target-resource-name}}",
        "dnsZonePrefix": "a1b22c333d44",
        "groupId": "managedInstance",
        "requestMessage": "please approve"
    }
}

    Paylaşılan özel bağlantı için anlamlı bir ad sağlayın. Paylaşılan özel bağlantı diğer özel uç noktaların yanında görünür. "shared-private-link-for-search" gibi bir ad nasıl kullanıldığını anımsatabilir.

    Önceki bir adımda aldığınız "dnsZonePrefix" içindeki DNS bölgesi adını yapıştırın.

    "privateLinkResourceId" öğesini düzenleyin ve yer tutucular için geçerli değerleri kullanın. Geçerli bir abonelik kimliği, kaynak grubu adı ve yönetilen örnek adı sağlayın.

  2. Dosyayı yerel olarak create-pe.json olarak kaydedin (veya sonraki adımda Azure CLI söz dizimini güncelleştirmeyi unutmayın) başka bir ad kullanın.

  3. Azure CLI'da, dosyanın geçerli konumunu not almak için yazın dir .

3 - Paylaşılan özel bağlantı oluşturma

  1. Komut satırından kullanarak az loginAzure'da oturum açın.

  2. Birden çok aboneliğiniz varsa, kullanmak istediğiniz aboneliği kullandığınızdan emin olun: az account show.

    Aboneliği ayarlamak için az account set --subscription {{subscription ID}}

  3. Komutunu çağırarak az restAzure AI Search'ün Yönetim REST API'sini kullanın.

    SQL yönetilen örnekleri için paylaşılan özel bağlantı desteği hala önizleme aşamasında olduğundan, yönetim REST API'sinin önizleme sürümüne ihtiyacınız vardır. Bu adım için veya sonraki bir önizleme API sürümünü kullanın 2021-04-01-preview . En son önizleme API'sinin sürümünü kullanmanızı öneririz.

    az rest --method put --uri https://management.azure.com/subscriptions/{{search-service-subscription-ID}}/resourceGroups/{{search service-resource-group}}/providers/Microsoft.Search/searchServices/{{search-service-name}}/sharedPrivateLinkResources/{{shared-private-link-name}}?api-version=2024-06-01-preview --body @create-pe.json

    Azure AI Search kaynağınızın abonelik kimliğini, kaynak grubu adını ve hizmet adını belirtin.

    JSON gövdesinde belirttiğiniz paylaşılan özel bağlantının adını sağlayın.

    Dosya konumundan uzaklaştıysanız create-pe.json dosyasının yolunu belirtin. Dosyanın geçerli dizinde olduğunu onaylamak için komut satırına yazabilirsiniz dir .

  4. komutunu çalıştırın.

Bu adımları tamamladığınızda, bekleme durumunda sağlanan paylaşılan bir özel bağlantınız olmalıdır. Bağlantının oluşturulması birkaç dakika sürer. Oluşturulduktan sonra, kaynak sahibinin çalışmadan önce isteği onaylaması gerekir.

Paylaşılan özel bağlantının durumunu Azure portalından de kontrol edebilirsiniz. Arama hizmeti sayfanızda, Ayarlar>Özellikleri'nin altında, paylaşılan özel bağlantı kaynaklarını bulmak ve JSON değerini görüntülemek için aşağı kaydırın. Sağlama durumu bekleme durumundan başarılı duruma geçtiğinde, sonraki adıma devam edebilirsiniz.

4 - Özel uç nokta bağlantısını onaylama

SQL Yönetilen Örneği tarafında, kaynak sahibinin oluşturduğunuz özel bağlantı isteğini onaylaması gerekir.

  1. Azure portalında yönetilen örneğin Güvenlik>Özel uç nokta bağlantılarını açın.

  2. Özel uç nokta bağlantılarını listeleyen bölümü bulun.

  3. Bağlantıyı seçin ve ardından Onayla'yı seçin. Durumun Azure portalında güncelleştirilmiş olması birkaç dakika sürebilir.

Özel uç nokta onaylandıktan sonra Azure AI Search, bu uç nokta için oluşturulan DNS bölgesinde gerekli DNS bölgesi eşlemelerini oluşturur.

5 - Paylaşılan özel bağlantı durumunu denetleme

Azure AI Arama tarafında, arama hizmeti Ağ oluşturma sayfasının Paylaşılan Özel Erişim sekmesini yeniden ziyaret ederek istek onayını onaylayabilirsiniz. Bağlantı durumu onaylanmalıdır.

6 - Dizin oluşturucuyu özel ortamda çalışacak şekilde yapılandırma

Artık bir dizin oluşturucu ve veri kaynağını yönetilen örneğinize giden özel bağlantı kullanacak şekilde yapılandırabilirsiniz.

Bu makalede rest istemcisi varsayılır ve REST API'leri kullanılır.

  1. Veri kaynağı tanımını normalde Azure SQL'de yaptığınız gibi oluşturun. Varsayılan olarak, yönetilen örnek 3342 numaralı bağlantı noktasını dinler, ancak bir sanal ağda 1433'te dinler.

    Daha önce kopyaladığınız bağlantı dizesi veritabanı adınıza ayarlanmış bir İlk Katalog ile belirtin.

    POST https://myservice.search.windows.net/datasources?api-version=2024-07-01
 Content-Type: application/json
 api-key: admin-key
 {
     "name" : "my-sql-datasource",
     "description" : "A database for testing Azure AI Search indexes.",
     "type" : "azuresql",
     "credentials" : { 
         "connectionString" : "Server=tcp:contoso.a1b22c333d44.database.windows.net,1433;Persist Security Info=false; User ID=<your user name>; Password=<your password>;MultipleActiveResultsSets=False; Encrypt=True;Connection Timeout=30;Initial Catalog=<your database name>"
        },
     "container" : { 
         "name" : "Name of table or view to index",
         "query" : null (not supported in the Azure SQL indexer)
         },
     "dataChangeDetectionPolicy": null,
     "dataDeletionDetectionPolicy": null,
     "encryptionKey": null
 }

  2. Dizin oluşturucu tanımını oluşturun ve dizin oluşturucuyu executionEnvironment "private" olarak ayarlayın.

    Dizin oluşturucu yürütmesi , arama hizmetinize özgü bir özel yürütme ortamında veya Microsoft tarafından barındırılan ve birden çok müşteri için pahalı beceri kümesi işlemlerini boşaltmak için kullanılan çok kiracılı bir ortamda gerçekleşir. Özel uç nokta üzerinden bağlanırken dizin oluşturucu yürütmesi özel olmalıdır.

     POST https://myservice.search.windows.net/indexers?api-version=2024-07-01
  Content-Type: application/json
  api-key: admin-key
    {
     "name": "indexer",
     "dataSourceName": "my-sql-datasource",
     "targetIndexName": "my-search-index",
     "parameters": {
         "configuration": {
             "executionEnvironment": "private"
         }
     },
     "fieldMappings": []
     }

  3. Dizin oluşturucuyu çalıştırın. Dizin oluşturucu yürütmesi başarılı olursa ve arama dizini doldurulursa, paylaşılan özel bağlantı çalışır.

Dizin oluşturucunun durumunu Azure portalında veya Dizin Oluşturucu Durum API'sini kullanarak izleyebilirsiniz.

Dizinin içeriğini denetlemek için Azure portalında Arama gezginini kullanabilirsiniz.

7 - Paylaşılan özel bağlantıyı test edin

Dizin oluşturucuyu önceki adımda çalıştırdıysanız ve yönetilen örneğinizden içeriği başarıyla dizine aldıysanız, test başarılı oldu. Ancak, dizin oluşturucu başarısız olursa veya dizinde içerik yoksa, nesnelerinizi değiştirebilir ve dizin oluşturucudan giden isteği çağırabilecek herhangi bir istemciyi seçerek testi yineleyebilirsiniz.

Azure portalında dizin oluşturucu çalıştırmak kolay bir seçenektir, ancak daha hassas olması için REST istemcisi ve REST API'lerini de deneyebilirsiniz. Arama hizmetinizin de özel bağlantı için yapılandırılmadığını varsayarsak, Azure AI Search'e REST istemci bağlantısı genel İnternet üzerinden olabilir.

Test için bazı anımsatıcılar şunlardır:

  • REST istemcisi kullanıyorsanız, paylaşılan özel bağlantıyı oluşturmak için Yönetim REST API'sini ve 2021-04-01-Preview API sürümünü kullanın. Dizin oluşturucuları ve veri kaynaklarını oluşturmak ve çağırmak için Search REST API'sini ve kararlı bir API sürümünü kullanın.

  • Dizin oluşturucu, veri kaynağı ve dizin oluşturmak için Verileri içeri aktarma sihirbazını kullanabilirsiniz. Ancak, oluşturulan dizin oluşturucu doğru yürütme ortamı ayarına sahip olmayacaktır.

  • Yürütme ortamı ve bağlantı dizesi dahil olmak üzere özellikleri değiştirmek için Azure portalında veri kaynağı ve dizin oluşturucu JSON'unu düzenleyebilirsiniz.

  • Azure portalında dizin oluşturucuyu sıfırlayabilir ve yeniden çalıştırabilirsiniz. Sıfırlama, tüm belgelerin tam yeniden işlenmesini zorladığı için bu senaryo için önemlidir.

  • Dizinin içeriğini denetlemek için Arama gezginini kullanabilirsiniz.

Ayrıca bkz.