Ymmärrä riippuvuussidonta työtilan välisessä käyttöönotossa

Kun Fabric-elementtejä otetaan käyttöön eri työtiloissa (esimerkiksi kehityksestä testaukseen ja tuotantoon), riippuvuudet alkioiden välillä voivat murtua. Jotkut kohteet tallentavat viittaukset riippuvuuksiinsa objekti-ID :inä (työtilakohtaisina GUID:inä), kun taas toiset käyttävät loogisia tunnisteita (tiedostoon tallennettuja ristiin työtilan siirrettäviä .platform tunnisteita).

Kohteet, jotka käyttävät loogisia tunnisteita määritelmissään, sitoutuvat oikein vastaavaan kohteeseen kohdetyötilassa. Objekti-ID:tä käyttävät kohteet pysyvät osoitetuina lähdetyötilassa, mikä rikkoo käyttöönoton.

Tämä artikkeli kartoittaa, mitkä Fabric-esinetyypit tukevat riippuvuussidontaa loogisten tunnisteiden kautta Git-integraatiota käytettäessä, ja mitkä eivät. Lisätietoja loogisista tunnisteista ja siitä, miten alkiot esitetään lähdekoodin hallinnassa, löydät osoitteesta Logical ID Fabric-tiedostossa.

Avainkäsitteet

  • Looginen tunniste: Automaattisesti luotu monikäyttöinen tunniste tiedostossa.platform. Saman loogisen tunnisteen omaavat kohteet käsitellään samana alkiona eri työtiloissa.
  • Object ID: Työtilakohtainen käyttöliittymä, joka tunnistaa tietyn instanssin. Objekti-ID:t eivät selviä työtilan välisestä käyttöönotosta ilman manuaalista puuttumista tai parametrisointia.
  • Riippuvuussidonta (Git): Kun synkronoit Git-haaran uuteen työtilaan, Fabric ratkaisee riippuvuusviittaukset loogisilla tunnisteilla, osoittaen automaattisesti oikeaan kohteeseen kohdetyötilassa.
  • Nimen tai URI:n mukaan: Jotkut kohteet viittaavat riippuvuuksiin näyttönimen tai URI:n perusteella ID:n sijaan. Nämä viittaukset saattavat ratkeaa oikein riippuen työtilojen nimeämiskäytännöistä.

Miten riippuvuussidonta toimii

Työtilassa kohteet viittaavat riippuvuuksiinsa objektitunnisteiden avulla. Kun Fabric vie kohteen Gitille, se korvaa osan näistä objekti-ID:istä tiedoston loogisilla ID.platform:illä. Kun synkronoit Git-haaran toiseen työtilaan, Fabric palauttaa nämä loogiset ID:t oikeisiin objektitunnisteisiin kohdetyötilassa. Tämä tekee riippuvuussitomisesta toimivan.

Kuitenkaan kaikkia riippuvuusviittauksia ei korvata loogisilla tunnisteilla viennin aikana. Objektit, jotka pitävät objekti-ID:t Git-esityksessään, osoittavat silti alkuperäiseen työtilaan synkronoinnin jälkeen, ja ne täytyy päivittää manuaalisesti tai parametrisoinnilla.

Important

Riippuvuussidonta koskee vain viittauksia Fabric-kohteiden välillä samassa työtilassa. Jos esine viittaa Fabric-kohteeseen eri työtilassa, kyseinen viittaus käyttää objekti-ID:tä eikä sido automaattisesti. Viittaukset yhteyksiin (datalähdeyhteydet, yhdyskäytävät) eivät myöskään sido automaattisesti. Käytä muuttujakirjastoja , joissa on ympäristökohtaiset arvojoukot, hallintaan yhteysviittauksia eri ympäristöjen välillä.

Riippuvuussidontayhteensopivuus

Seuraavat taulukot näyttävät, sitoutuvatko kunkin Fabric-esinetyypin riippuvuudet oikein, kun otat käyttöön työtilojen välillä. Tällä hetkellä tämä artikkeli käsittelee Git-integraatiokäyttäytymistä . Koska sitominen määräytyy sen mukaan, miten kukin alkio tallentaa riippuvuusviittauksensa määritelmässään, sama käyttäytyy myös muihin käyttöönottomekanismeihin, jotka käyttävät näitä määritelmiä uudelleen, kuten käyttöönottoputket ja tuontirajapinnat (bulk).

Nämä taulukot olettavat, että riippuvuus on toinen alkio samassa työtilassa kuin lähdekohde. Viittaus kohteeseen toisessa työtilassa ei koskaan sido automaattisesti. Se pysyy kiinnitettynä lähdeobjektin ID:hen riippumatta taulukossa esitetystä arvosta.

Automaattisidonta Git-sarakkeessa osoittaa:

  • Kyllä: Gitin kohdemäärittely tallentaa riippuvuusviitteen loogisena tunnisteena. Kun synkronoit haaran uuteen työtilaan, viite sitoutuu automaattisesti kyseisen työtilan vastaavaan kohteeseen.
  • Ei: Gitin kohdemäärittely tallentaa riippuvuusviitteen objekti-ID:nä (työtilakohtainen GUID). Viittaus osoittaa edelleen lähdetyötilaan synkronoinnin jälkeen. Sinun täytyy päivittää tai parametrisoida se manuaalisesti työtilan ylittävää käyttöönottoa varten.
  • Osittainen: Kohde ratkaisee riippuvuuden nimen tai URI:n perusteella, mikä saattaa toimia, jos nimeäminen on johdonmukaista eri työtilojen välillä.

Notebooks

Riippuvuus Automaattinen sitominen Gitissä Huomautuksia
Lakehouse Yes Vaatii "Lakehouse Auto-Binding in Git" -toiminnon käyttöönoton muistikirjan asetuksista. Kun se on käytössä, objektin ID korvataan loogisella ID:llä .notebook-settings.json Tämä asetus on oletusarvoisesti poissa käytöstä. Lisätietoja löytyy Lakehouse-automaattisitomisesta Gitissä.
Ympäristö Yes
Peilattu tietokanta No

Note

Notebookista Lakehouseen -sidonta ei ole oletuksena käytössä. Sinun täytyy ottaa käyttöön "Lakehouse Auto-Binding in Git" -asetus jokaisen kannettavan asetuksista. Lisätietoja löytyy kohdasta Notebookin lähdekoodin hallinta ja käyttöönotto.

Raportit

Riippuvuus Automaattinen sitominen Gitissä Huomautuksia
Semanttinen malli (Power BI -raportista) Osittainen Raportti viittaa malliin suhteellisen byPath viitteen kautta , definition.pbirei eksplisiittisen loogisen tunnisteen kautta. Se ratkeaa oikein, kun malli sijoittuu samaan suhteelliseen sijaintiin kohdetyötilassa, mutta ei sido loogisen tunnisteen kautta. Lisätietoja löytyy Power BI Desktop Projects report -kansiosta.
Semanttinen malli (sivutetusta raportista) No Raportin yhteysmerkkijono viittaa semanttiseen malliin työtilakohtaisella tunnistella, jota ei kirjoiteta uudelleen käyttöönoton yhteydessä, joten se pysyy osoitettuna lähdemalliin. Sinun täytyy päivittää tämä viite työtilan väliseen käyttöönottoon. (Raportin muodostin -ohjelmassa laaditut raportit, joissa malliin viitataan nimeltä, voidaan sen sijaan ratkaista näyttönimellä, joka on osittainen.)

Pipeline

Riippuvuus Automaattinen sitominen Gitissä Huomautuksia
Pipeline Yes
Notebook Yes
Dataflow Gen2 Yes
SQL-tietokanta Yes
Spark-työn määritelmä No SparkJobDefinition-toiminto viittaa Spark Job Definitioniin objekti-ID:llä, ei loogisella ID:llä, joten se pysyy osoitettuna lähdealkiolla käyttöönoton jälkeen. Sinun täytyy parametrisoida tämä arvo työtilan välisessä käyttöönotossa.
Lakehouse Yes
Semanttinen malli No PBISemanticModelRefresh-aktiivisuus viittaa semanttiseen malliin kohde-ID:n perusteella, ei loogisen tunnisteen perusteella. Sinun täytyy parametrisoida tämä arvo työtilan välisessä käyttöönotossa.
Varasto No Varasto artifactId ratkeaa loogisen tunnisteen kautta ja sitoo uudelleen, mutta linkedService tallentaa myös lähdetyötilan SQL endpoint:n, jota ei kirjoiteta uudelleen. Parametrisoi endpoint työtilan välisen käyttöönoton parametrisoinnin.

Semanttiset mallit

Riippuvuus Automaattinen sitominen Gitissä Huomautuksia
Semanttinen malli Osittainen Ketjutetut tai yhdistelmämalliviitteet käyttävät yhteysjonoja nimeltä.
SQL Analytics Endpoint (lakehouse) No TMDLexpressions.tmdl:n Direct Lake -yhteysmerkkijono sisältää työtilakohtaisen päätepisteen URL-osoitteen ja tietokannan käyttöliittymän. Nämä parametrit täytyy korvata työtilan välisessä käyttöönotossa.
KQL-tietokanta No TMDL-lausekkeissa on klusterin URI yhteysmerkkijono, joka sisältää työtilakohtaisia arvoja.
SQL-tietokanta No TMDL-lausekkeiden yhteysmerkkijono sisältää työtilakohtaisia arvoja.
Varasto No Yhteys varaston SQL-analytiikkapäätepisteeseen käyttää työtilakohtaista URL-osoitetta.

Järvitalot

Riippuvuus Automaattinen sitominen Gitissä Huomautuksia
Lakehouse (oikotie) Yes Sisäiset OneLake-pikakuvakkeet, jotka osoittavat toiseen Fabric-kohteeseen, kuten lakehouseen tai varastoon, tallennetaan loogisena tunnisteena ja sitotaan uudelleen kohde-työtilan kohteeseen. Pikakuvakkeet ulkoisiin lähteisiin, kuten Azure Data Lake Storage Gen2:een tai Amazon S3:een, osoittavat Fabric:n ulkopuolelle ja kantavat sen sijaan yhteysviitteen, joten ne eivät ole logical-ID-sidon alaisia. Täydellisen listan oikotien kohteista löytyy OneLake-oikoteistä. Käyttöönoton käyttäytymisestä katso Lakehouse Git -integraatio- ja käyttöönottoputket.

Datavirrat (Gen2)

Oletuksena Dataflow Gen2 luo absoluuttisia viittauksia Fabric-kohteisiin: kysely tallentaa lähdetyötilan ID:n ja kohteen objekti-ID:n, joita ei kirjoiteta uudelleen käyttöönoton yhteydessä. Lähdeviite voi sen sijaan käyttää suhteellista viitettä: kun valitset kohteen !( Current Workspace) solmussa Fabric-liittimessä, kysely tallentaa kohteen nimeltä (ei GUID-tiedostoja), ja se ratkaistaan vastaavaksi kohteeksi kohdetyötilassa käyttöönoton yhteydessä. Tulostuskohteet käyttävät aina absoluuttisia viittauksia eivätkä sitoudu uudelleen. Kohteille ja mille tahansa absoluuttisille lähdeviitteille parametrisoi arvot työtilan välisessä käyttöönotossa. Lisätietoja löytyy kohdasta Relative references with Fabric connectors in Dataflow Gen2 ja Dataflow Gen2 with CI/CD and Git integration.

Lähdelähteet:

Riippuvuus Automaattinen sitominen Gitissä Huomautuksia
Lakehouse Osittainen Sitoo uudelleen vain, kun se on luotu suhteellisena viitteenä (!( Nykyinen työtila)); Oletus absoluuttinen viite ei sitoudu uudelleen.
Varasto Osittainen Sitoo uudelleen vain, kun se on luotu suhteellisena viitteenä (!( Nykyinen työtila)); Oletus absoluuttinen viite ei sitoudu uudelleen.

Kohdeviitteet:

Riippuvuus Automaattinen sitominen Gitissä Huomautuksia
Lakehouse No
Varasto No
SQL-tietokanta No

Spark-työn määritykset

Riippuvuus Automaattinen sitominen Gitissä Huomautuksia
Ympäristö Yes
Lakehouse No Se defaultLakehouseArtifactId käyttää objekti-ID:tä.

Kopiointityöt

Riippuvuus Automaattinen sitominen Gitissä Huomautuksia
Lakehouse Yes
Varasto No Varasto artifactId ratkeaa loogisen tunnisteen kautta ja sitoo uudelleen, mutta linkedService tallentaa myös lähdetyötilan SQL endPoint:n, jota ei kirjoiteta uudelleen. Parametrisoi endPoint työtilan välisen käyttöönoton parametrisoinnin.
SQL-tietokanta Yes

GraphQL-ohjelmointirajapinnat

Riippuvuus Automaattinen sitominen Gitissä Huomautuksia
SQL Endpoint Yes
Varasto Yes
SQL-tietokanta Yes

Kaikissa GraphQL API -tietolähteissä saatat joutua konfiguroimaan yhteyden ja tunnistetiedot uudelleen käyttöönoton jälkeen.

Tapahtumavirrat

Riippuvuus Automaattinen sitominen Gitissä Huomautuksia
Lakehouse Yes
Eventhouse Yes Kaikki kohteet ovat täysin tuettuja CI/CD:lle, kun kohteet ovat samassa työtilassa. Eventhousessa, jossa on Direct Ingestion -tila, saatat joutua konfiguroimaan yhteyden manuaalisesti uudelleen käyttöönoton jälkeen. Lisätietoja löytyy Eventstream CI/CD:stä.
Aktivaattori (Refleksi) Yes Kaikki kohteet ovat täysin tuettuja CI/CD:lle, kun kohteet ovat samassa työtilassa. Lisätietoja löytyy Eventstream CI/CD:stä.

KQL-tuotteet

Riippuvuus Automaattinen sitominen Gitissä Huomautuksia
KQL-tietokanta tapahtumatalolle Yes Sisääntulo parentEventhouseItemIdDatabaseProperties.json on looginen tunniste ja sitoutuu kohdetapahtumahuoneeseen. KQL-tietokanta otetaan käyttöön emotapahtumatalon lapsena.
KQL-kyselysarja KQL-tietokantaan Osittainen Ratkaisu tapahtuu clusterUri ja databaseNameavulla, ei item ID:llä. Määritelmä sisältää , databaseItemIdmutta kyseessä on objekti-ID, joka ei sitoudu uudelleen, joten resoluutio riippuu URI:stä eri ympäristöissä.
Real-Time Dashboardista KQL-tietokantaan Osittainen Käyttää dataSources taulukkoa, jossa on klusteri-URI:t. Sama kaava kuin KQL querysetissä.

Varastot

Riippuvuus Automaattinen sitominen Gitissä Huomautuksia
Varasto (ristiviittaus) No Viittaukset muihin varastoihin käyttävät objektitunnisteita.
SQL Endpoint No SQL Endpoint -viittaukset käyttävät työtilakohtaisia tunnisteita.

Muuttujakirjastot

Riippuvuus Automaattinen sitominen Gitissä Huomautuksia
Fabric-esineet (ItemReference type) No Muuttuvat ItemReference tyypit tallentavat workspaceId ja itemId toimivat raakana GUIDina. Sinun täytyy päivittää tai ohittaa nämä arvot manuaalisesti eri ympäristöjen arvomäärillä.

Esineet, joilla ei ole riippuvuuksia

Seuraavilla kohteilla ei ole työtilan riippuvuuden sitomiseen liittyviä huolia:

  • Ympäristö
  • SQL-tietokanta
  • Tapahtumatalo (konttiesine; KQL:n tietokannat viittaavat siihen)
  • Peilattu tietokanta (vain ulkoisen lähdekoodin konfiguraatio)

Yhteenveto

Kun otat Fabric-aluksia käyttöön työtilojen välillä, riippuvuudet alkioiden välillä voivat rikkoutua, jos viittaukset tallennetaan työtilakohtaisina objekti-ID:inä siirrettävien loogisten tunnisteiden sijaan. Kaikki esinetyypit eivät tue riippuvuussitomista loogisten tunnisteiden kautta. Ennen kuin asetat työpisteiden välisen käyttöönoton, tutustu tämän artikkelin yhteensopivuustaulukoihin tunnistaaksesi, mitkä riippuvuudet sitoutuvat automaattisesti ja mitkä vaativat manuaalista parametrisointia.

Liittyvä sisältö

  • Last updated on