Jaa

NotebookUtils (entinen MSSparkUtils) for Fabric

Notebook Utilities (NotebookUtils) on sisäinen paketti, jonka avulla voit helposti suorittaa yleisiä tehtäviä Fabric Notebookissa. NotebookUtils-apuohjelman avulla voit käsitellä tiedostojärjestelmiä, saada ympäristömuuttujia, ketjuttaa muistikirjoja yhteen ja käsitellä salaisuuksia. NotebookUtils-paketti on saatavilla PySpark (Python) Scala-, SparkR-muistikirjoissa ja Fabric-putkissa.

Note

  • MsSparkUtils on virallisesti nimetty uudelleen NotebookUtilsiksi. Nykyinen koodi pysyy taaksepäin yhteensopivana eikä aiheuta rikkoutuvia muutoksia. On vahvasti suositeltavaa päivittää notebookutilsiin, jotta jatkuva tuki ja pääsy uusiin ominaisuuksiin varmistetaan. Mssparkutils-nimitila poistetaan käytöstä tulevaisuudessa.
  • NotebookUtils on suunniteltu toimimaan Spark 3.4 (Runtime v1.2) ja uudempien versioiden kanssa. Kaikki uudet ominaisuudet ja päivitykset tuetaan jatkossa yksinoikeudella notebookutils-nimiavaruudessa.

NotebookUtils-moduulit

NotebookUtils tarjoaa seuraavat moduulit. Valitse moduuli nähdäksesi yksityiskohtaisen dokumentaation, koodiesimerkit ja parhaat käytännöt.

Moduuli Nimitila Description
Tiedostojärjestelmän apuohjelmat notebookutils.fs Työskentele tiedostojen ja hakemistojen kanssa ADLS Gen2:ssa, Azure Blob Storagessa ja Lakehouse-tallennuksessa. Sisältää kopiointi-, siirto-, luku-, kirjoitus-, poisto- ja listatoiminnot.
Tiedoston kiinnitys ja irrotus notebookutils.fs Liitä etätallennus (ADLS Gen2) Spark-solmuihin paikallisina liitospisteinä yksinkertaistamaan tiedostojen käyttöä.
Muistikirjan käyttö ja orkestrointi notebookutils.notebook Aja ja ketjuta muistikirjat yhdessä, mukaan lukien rinnakkainen suoritus DAG-tuella, työtilan ristiinviittaukset ja exit-arvot.
Muistikirjan hallinta notebookutils.notebook Luo, hanki, päivitä, poista ja listaa muistikirjan artefakteja ohjelmalla.
Credentials-apuohjelmat notebookutils.credentials Hanki pääsytunnukset Azure-palveluille ja hae salaisuudet Azure Key Vaultista.
Lakehouse-palvelut notebookutils.lakehouse Luo, hae, päivitä, poista ja hallinnoi Lakehouse-kohteita ja taulukoita ohjelmallisesti.
Ajonaikainen konteksti notebookutils.runtime Pääset käsiksi istuntokontekstitietoihin, kuten muistikirjan nimeen, työtilan yksityiskohtiin ja suorituskontekstiin.
Istuntojen hallinta notebookutils.session Lopeta interaktiiviset istunnot ja käynnistä Python-tulkki uudelleen.
User Data Function (UDF) -apuohjelmat notebookutils.udf Hae ja kutsu User Data -funktioita muistikirjoista.
Muuttuvien kirjastojen apuohjelmat notebookutils.variableLibrary Pääse käsiksi keskitetysti hallittuihin muuttujiin ja konfiguraatioihin muuttujakirjaston kohteista.

Saadaksesi yleiskatsauksen kaikista saatavilla olevista moduuleista ja metodeista, suorita:

notebookutils.help()

Saadaksesi apua tiettyyn moduuliin, suorita:

notebookutils.fs.help()
notebookutils.notebook.help()
notebookutils.credentials.help()

Tunnetut ongelmat

  • Kun käytetään ajonaikaista versiota yli 1.2 ja ajetaan notebookutils.help(), luetellut fabricClient - ja PBIClient-rajapinnat eivät ole vielä tuettuja, mutta ne tulevat saataville tulevassa julkaisussa.

Liittyvä sisältö

  • Last updated on