Hallittujen yksityisten päätepisteiden luominen ja käyttäminen

Käyttäjät, joilla on Microsoft Fabric -työtilan järjestelmänvalvojan oikeudet, voivat luoda, tarkastella ja poistaa hallittuja yksityisiä päätepisteitä Fabric-portaalista työtilan asetusten kautta.

• Käyttäjä voi myös seurata hallittujen yksityisten päätepisteiden tilaa ja hyväksyntäprosessia työtilan asetusten Verkon suojaus -osiosta.

• Käyttäjä voi käyttää tietolähteitä yksityisen päätepisteen nimellä Fabric Spark -kuormituksista.

Edellytykset

Microsoft.Network -resurssipalvelu on rekisteröitävä Azure-tilaukseen

Hallitun yksityisen päätepisteen luominen

1. Siirry Fabric-työtilassa työtilan asetuksiin, valitse Verkon suojaus -välilehti ja valitse sitten Hallittu yksityinen päätepiste -osiosta Luo-vaihtoehto .

   

   Luo hallittu yksityinen päätepiste -valintaikkuna avautuu.

   

2. Määritä yksityisen päätepisteen nimi ja kopioi se Azure-resurssin resurssitunnisteessa. Resurssitunnus löytyy ominaisuudet-välilehdestä Azure-portaali sivulla. Lisätietoja on ohjeaiheessa Azure-resurssitunnuksen hakeminen

   Muistiinpano

   Hallitun yksityisen päätepisteen luomista täydellisellä toimialuenimellä ei tueta.

   Kun olet valmis, valitse Luo.

3. Kun hallittu yksityinen päätepiste valmistellaan, Aktivointi-tilaksi muuttuu Onnistui.

   

   Lisäksi pyyntö yksityisestä päätepisteen käyttöoikeudesta lähetetään tietolähteeseen. Tietolähteen järjestelmänvalvojille ilmoitetaan tietolähteiden Azure-portaali resurssisivuilla. Siellä he näkevät odottavan käyttöoikeuspyynnön ja pyyntöviestin.

Esimerkiksi SQL Serverin avulla käyttäjät voivat siirtyä Azure-portaali ja hakea SQL Server -resurssia.

1. Valitse Resurssi-sivulla Verkkopalvelut siirtymisvalikosta ja valitse sitten Yksityinen käyttö -välilehti.

   

2. Tietolähteen järjestelmänvalvojien pitäisi pystyä tarkastelemaan aktiivisia yksityisiä päätepisteyhteyksiä ja uusia yhteyspyyntöjä.

   

3. Järjestelmänvalvojat voivat joko hyväksyä tai hylätä liiketoiminnan oikeutuksen perusteella.

   

4. Kun tietolähteen järjestelmänvalvoja on hyväksynyt tai hylännyt pyynnön, tila päivitetään Fabric-työtilan asetukset -sivulla päivityksen yhteydessä.

   

5. Kun tilaksi muuttuu hyväksytty, päätepistettä voidaan käyttää muistikirjoissa tai Spark-työmääritelmissä tietolähteeseen tallennettujen tietojen käyttämiseksi Fabric-työtilasta.

Luo hallittu yksityinen päätepiste Azure API Management -ohjelmalle

Fabric-portaali ei tällä hetkellä tue hallitun yksityisen päätepisteen luomista Azure API Management -palvelulle. Käytä sen sijaan Fabric REST API:a.

1. Hanki Microsoft Entra access token Fabric-palvelulle. Lisätietoja saat Fabric API:n pikakäynnistä.

2. Lähetä seuraava pyyntö. Korvaa paikkamerkit työtilan ID:llä ja API:n hallintaresurssitiedolla.

   POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/managedPrivateEndpoints
   Authorization: Bearer {accessToken}
   Content-Type: application/json
   

   {
     "name": "mpe-apim-gateway",
     "targetPrivateLinkResourceId": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.ApiManagement/service/{apimName}",
     "targetSubresourceType": "gateway",
     "requestMessage": "Please approve the managed private endpoint for the API Management gateway.",
     "targetFQDNs": [
       "{apimName}.azure-api.net"
     ]
   }
   

   Vain API Management Gateway -aliresurssi tukee saapuvia Yksityinen linkki -yhteyksiä.

3. Azure-portaalissa avaa API Management -instanssi ja valitse Network>Inbound private endpoint connections.

4. Yksityisten päätelaitteiden listasta avaa kontekstivalikko (...) odottavalle yhteydelle ja valitse sitten Hyväksy. Sinun ei tarvitse avata Fabric:n hallinnoimaa yksityistä päätelaiteresurssia hyväksyäksesi yhteyden.

5. Päivitä Fabric-työtilan verkkoturvallisuusosio ja varmista, että yhteyden tila on hyväksytty.

Jos hallitulla yksityisellä päätepisteellä on prognoisointitila Failed, luo tukipyyntö, jotta palvelutiimi voi tutkia provisionointivirheen.

Hallittujen yksityisten päätepisteiden käyttäminen Fabricissa

Microsoft Fabric -muistikirjat tukevat saumatonta vuorovaikutusta suojattujen verkkojen takana olevien tietolähteiden kanssa hallittujen yksityisten päätepisteiden avulla tietojen tutkimiseen ja käsittelyyn. Muistikirjassa käyttäjät voivat nopeasti lukea tietoja suojatuista tietolähteistä (ja kirjoittaa tietoja takaisin) Lakehouse-tallennustilaan eri tiedostomuodoissa.

Tämä opas sisältää koodinäytteitä, joiden avulla pääset alkuun omissa muistikirjoissasi ja voit käyttää tietoja tietolähteistä, kuten SQL DB:stä, hallittujen yksityisten päätepisteiden kautta.

Edellytykset

1. Tietolähteen käyttöoikeus. Tässä esimerkissä tarkastellaan Azure SQL Serveriä ja Azure SQL -tietokantaa.

2. Kirjaudu sisään Microsoft Fabriciin ja Azure-portaali.

3. Siirry Azure SQL Serverin resurssisivulle Azure-portaali ja valitse Ominaisuudet-valikko. Kopioi sen SQL Serverin resurssitunnus, johon haluat muodostaa yhteyden Microsoft Fabricista.

4. Luo hallittu yksityinen päätepiste Fabric Networkin suojausasetukset -sivulta noudattamalla kohdassa Hallitun yksityisen päätepisteen luominen lueteltuja vaiheita.

5. Kun SQL-palvelimen tietolähteen järjestelmänvalvoja on hyväksynyt uuden yksityisen päätepisteen yhteyspyynnön, sinun pitäisi pystyä käyttämään juuri luotua hallittua yksityistä päätepistettä.

Yhteyden muodostaminen tietolähteeseen muistikirjoista

1. Kirjaudu sisään Microsoft Fabric -portaaliin.

2. Vaihda Kehitä-käyttökokemus aloitussivun vasemmalla puolella olevan käyttökokemuksen vaihtajan avulla.

3. Siirry haluamaasi työtilaan tai luo uusi tarvittaessa.

4. Luo muistikirja valitsemalla työtilasta Uusi kohde ja sitten Muistikirja.

5. Nyt voit muistikirjassa määrittää SQL-tietokannan nimen ja sen yhteysominaisuudet muodostamalla yhteyden hallitun yksityisen päätepisteyhteyden kautta, joka on määritetty lukemaan tietokannan taulukoita ja kirjoittamaan ne Lakehouseen Microsoft Fabricissa.

6. Seuraava PySpark-koodi näyttää, miten voit muodostaa yhteyden SQL-tietokantaan.

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")

Nyt kun yhteys on muodostettu, seuraava vaihe on luoda tietokehys taulukon lukemiseksi SQL-tietokannassa.

Tuetut tietolähteet

Microsoft Fabric tukee yli 26 tietolähdettä, joiden avulla muodostetaan yhteys hallittuihin yksityisiin päätepisteisiin. Käyttäjien on määritettävä resurssitunnus, joka löytyy hänen tietolähteensä Ominaisuudet-asetussivulta Azure-portaali. Varmista, että resurssitunnuksen muotoa noudatetaan seuraavassa taulukossa esitetyllä tavalla.

Huomaa, että hallitun yksityisen päätepisteen luomista yksityiseen linkkipalveluun Fabric-vuokraajallesi ei tueta.

Liittyvä sisältö

• Tietoja Fabricin hallituista yksityisistä päätepisteistä
• Tietoja yksityisistä linkeistä Fabricissa
• Fabric-hallittujen näennäisverkkojen yleiskatsaus