Share via


Yönetilen özel uç noktaları oluşturma ve kullanma (önizleme)

Microsoft Fabric çalışma alanında yönetici izinleri olan kullanıcılar, çalışma alanı ayarları aracılığıyla Doku portalından yönetilen özel uç noktaları oluşturabilir, görüntüleyebilir ve silebilir.

  • Kullanıcı, yönetilen özel uç noktaların durumunu ve onay işlemini çalışma alanı ayarlarının Ağ güvenliği bölümünden de izleyebilir.

  • Kullanıcı, Doku Spark iş yüklerinden özel uç nokta adını kullanarak veri kaynaklarına erişebilir.

Yönetilen özel uç nokta oluşturma

  1. Doku çalışma alanında çalışma alanı ayarlarına gidin, Ağ güvenliği sekmesini seçin ve ardından Yönetilen Özel Uç Nokta bölümünde Oluştur seçeneğini belirleyin.

    Screenshot of the Networks security tab in workspace settings.

    Yönetilen Özel uç nokta oluştur iletişim kutusu açılır.

    Screenshot of the Network security tab in the workspace settings.

  2. Özel uç nokta için bir ad belirtin ve Azure kaynağının kaynak tanımlayıcısını kopyalayın. Kaynak tanımlayıcısı Azure portalı sayfasındaki özellikler sekmesinde bulunabilir.

    İşiniz bittiğinde Oluştur’u seçin.

  3. Yönetilen özel uç nokta sağlandığında Etkinleştirme durumu Başarılı olarak değişir.

    Screenshot of managed private endpoint provisioning success indication on the Networking tab.

    Ayrıca özel uç nokta erişimi isteği de veri kaynağına gönderilir. Veri kaynağı yöneticilerine, veri kaynakları için Azure portalı kaynak sayfalarında bildirim gönderilir. Burada istek iletisiyle bekleyen bir erişim isteği görürler.

Örnek olarak SQL Server'ı ele alan kullanıcılar Azure portalına gidebilir ve "SQL Server" kaynağını arayabilir.

  1. Kaynak sayfasında, gezinti menüsünden Ağ'ı seçin ve ardından Özel Erişim sekmesini seçin.

    Screenshot showing the Private access tab on the Networking page of a resource in the Azure portal.

  2. Veri kaynağı yöneticilerinin etkin özel uç nokta bağlantılarını ve yeni bağlantı isteklerini görüntüleyebilmesi gerekir.

    Screenshot showing pending requests on the Private access tab.

  3. Yöneticibir iş gerekçesi sağlayarak onaylayın veya reddedin.

    Screenshot showing the approval form.

  4. İstek veri kaynağı yöneticisi tarafından onaylandıktan veya reddedildikten sonra, yenilemenin ardından Doku çalışma alanı ayarları sayfasında durum güncelleştirilir.

    Screenshot showing the managed private endpoint in the approved state.

  5. Durum onaylandı olarak değiştirildiğinde, uç nokta doku çalışma alanından veri kaynağında depolanan verilere erişmek için not defterlerinde veya Spark iş tanımlarında kullanılabilir.

Doku'da yönetilen özel uç noktaları kullanma

Microsoft Fabric not defterleri, veri araştırma ve işleme için yönetilen özel uç noktaları kullanarak güvenli ağların arkasındaki veri kaynaklarıyla sorunsuz etkileşimi destekler. Bir not defteri içinde kullanıcılar, korumalı veri kaynaklarından verileri çeşitli dosya biçimlerinde hızla okuyabilir (ve göl evlerine geri yazabilir).

Bu kılavuz, yönetilen özel uç noktalar aracılığıyla SQL DB gibi veri kaynaklarından verilere erişmek için kendi not defterlerinizde çalışmaya başlamanıza yardımcı olacak kod örnekleri sağlar.

Önkoşullar

  1. Veri kaynağına erişim. Bu örnek, Azure SQL Server ve Azure SQL Veritabanı'ne bakar.

  2. Microsoft Fabric'de ve Azure portalında oturum açın.

  3. Azure portalında Azure SQL Server'ın kaynak sayfasına gidin ve Özellikler menüsünü seçin. Microsoft Fabric'ten bağlanmak istediğiniz SQL Server'ın Kaynak Kimliğini kopyalayın.

  4. Yönetilen özel uç nokta oluşturma bölümünde listelenen adımları kullanarak, Yapı Ağı güvenlik ayarları sayfasından yönetilen özel uç noktayı oluşturun.

  5. SQL sunucusunun veri kaynağı yöneticisi yeni özel uç nokta bağlantı isteğini onayladıktan sonra yeni oluşturulan Yönetilen Özel Uç Nokta'yı kullanabilmeniz gerekir.

Not Defterlerinden Veri Kaynağına Bağlan

  1. Microsoft Fabric çalışma alanında, Synapse Veri Madenciliği deneyimine geçmek için giriş sayfanızın sol tarafındaki deneyim değiştiriciyi kullanın.

    Screenshot showing how to get into the data engineering experience in Fabric.

  2. Oluştur'u seçin ve yeni bir not defteri oluşturun.

  3. Şimdi not defterinde, SQL veritabanının adını ve bağlantı özelliklerini belirterek, veritabanındaki tabloları okumak ve Bunları Microsoft Fabric'teki lakehouse'unuza yazmak için ayarlanmış yönetilen özel uç nokta bağlantısı üzerinden bağlanabilirsiniz.

  4. Aşağıdaki PySpark kodu bir SQL veritabanına nasıl bağlanacaklarını gösterir.

serverName = "<server_name>.database.windows.net"
database = "<database_name>"
dbPort = 1433
dbUserName = "<username>"
dbPassword = “<db password> or reference based on Keyvault>”

from pyspark.sql import SparkSession

spark = SparkSession.builder \
    .appName("Example") \
    .config("spark.jars.packages", "com.microsoft.azure:azure-sqldb-spark:1.0.2") \
    .config("spark.sql.catalogImplementation", "com.microsoft.azure.synapse.spark") \
    .config("spark.sql.catalog.testDB", "com.microsoft.azure.synapse.spark") \
    .config("spark.sql.catalog.testDB.spark.synapse.linkedServiceName", "AzureSqlDatabase") \ .config("spark.sql.catalog.testDB.spark.synapse.linkedServiceName.connectionString", f"jdbc:sqlserver://{serverName}:{dbPort};database={database};user={dbUserName};password={dbPassword}") \ .getOrCreate()

    
jdbcURL = "jdbc:sqlserver://{0}:{1};database={2}".format(serverName,dbPort,database)
connection = {"user":dbUserName,"password":dbPassword,"driver": "com.microsoft.sqlserver.jdbc.SQLServerDriver"}

df = spark.read.jdbc(url=jdbcURL, table = "dbo.Employee", properties=connection)
df.show()
display(df)

# Write the dataframe as a delta table in your lakehouse
df.write.mode("overwrite").format("delta").saveAsTable("Employee")

# You can also specify a custom path for the table location
# df.write.mode("overwrite").format("delta").option("path", "abfss://yourlakehouse.dfs.core.windows.net/Employee").saveAsTable("Employee")

Bağlantı kurulduğuna göre, sonraki adım SQL Veritabanı tabloyu okumak için bir veri çerçevesi oluşturmaktır.

Desteklenen veri kaynakları

Microsoft Fabric, yönetilen özel uç noktaları kullanarak bağlanmak için 25'in üzerinde veri kaynağını destekler. Kullanıcıların kaynak tanımlayıcısını belirtmesi gerekir. Bu tanımlayıcı, Azure portalındaki veri kaynaklarının Özellikler ayarları sayfasında bulunabilir.

Hizmet Kaynak Kimliği Biçimi
Bilişsel Hizmetler /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.CognitiveServices/accounts/{resource-name}
Azure Databricks /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Databricks/workspaces/{workspace-name}
MariaDB için Azure Veritabanı /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.DBforMariaDB/servers/{server-name}
MySQL için Azure Veritabanı /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.DBforMySQL/servers/{server-name}
PostgreSQL için Azure Veritabanı /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.DBforPostgreSQL/servers/{server-name}
MongoDB için Azure Cosmos DB /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.DocumentDB/databaseAccounts/{account-name}
NoSQL için Azure Cosmos DB /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.DocumentDB/databaseAccounts/{account-name}
Azure İzleyici Özel Bağlantı Kapsamları /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft. Analizler/privateLinkScopes/{scope-name}
Azure Key Vault /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.KeyVault/vaults/{vault-name}
Azure Veri Gezgini (Kusto) /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Kusto/clusters/{cluster-name}
Azure Machine Learning /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.MachineLearningServices/workspaces/{workspace-name}
Application Gateway /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Network/applicationGateways/{gateway-name}
Özel Bağlantı Hizmeti /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Network/privateLinkServices/{service-name}
Microsoft Purview /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Purview/accounts/{account-name}
Azure Search /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Search/searchServices/{service-name}
Azure SQL Veritabanı /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Sql/servers/{server-name}
Azure SQL Veritabanı (Yönetilen Örnek) /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Sql/managedInstances/{instance-name}
Azure Blob Storage /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft. Depolama/storageAccounts/{storage-account-name}
Azure Data Lake Storage 2. Nesil /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft. Depolama/storageAccounts/{storage-account-name}
Azure Dosya Depolama /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft. Depolama/storageAccounts/{storage-account-name}
Azure Kuyruk Depolama /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft. Depolama/storageAccounts/{storage-account-name}
Azure Tablo Depolaması /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft. Depolama/storageAccounts/{storage-account-name}
Azure Synapse Analytics /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Synapse/workspaces/{workspace-name}
Azure Synapse Analytics (Yapıtlar) /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Synapse/workspaces/{workspace-name}
Azure İşlevleri /subscriptions/{subscription-id}/resourceGroups/{resource-group-name}/providers/Microsoft.Web/sites/{function-app-name}