Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
Notebook Utilities (NotebookUtils) on sisäänrakennettu paketti, joka auttaa sinua suorittamaan yleisiä tehtäviä muistikirjoissa helposti Microsoft Fabric -muodossa. 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. |
| Liiketoimintatapahtumapalvelut | notebookutils.businessEvents |
Julkaise analyyttisiä oivalluksia, vikojen havaitsemista ja räätälöityjä liiketoimintasääntöjä toiminnallisina liiketoimintatapahtumina. |
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.