Jegyzet
Az oldalhoz való hozzáférés engedélyezést igényel. Próbálhatod be jelentkezni vagy könyvtárat váltani.
Az oldalhoz való hozzáférés engedélyezést igényel. Megpróbálhatod a könyvtár váltását.
Databricks Utilities (
Ez a cikk a Databricks Utilities (dbutils) hivatkozását tartalmazza. A segédprogramok olyan parancsokat biztosítanak, amelyek lehetővé teszik a Databricks-környezet jegyzetfüzetekből való használatát. Kezelheti például a fájlokat és az objektumtárolókat, és titkos kulcsokkal dolgozhat.
dbutils Python-, R- és Scala-jegyzetfüzetekben érhetők el.
Feljegyzés
dbutils csak a DBFS-t használó számítási környezeteket támogatja.
segédprogrammodulok
Az alábbi táblázat a Databricks Utilities modulokat sorolja fel, amelyeket dbutils.help()használatával kérdezhet le.
| Modul | Leírás |
|---|---|
| adat | Segédprogramok az adathalmazok megértéséhez és kezeléséhez (KÍSÉRLETI) |
| Fs | Segédprogramok a Databricks fájlrendszer (DBFS) eléréséhez |
| munkák | Segédprogramok a feladatok funkcióinak kihasználásához |
| könyvtár | Elavult. Segédprogramok munkamenet-hatókörű kódtárak kezeléséhez |
| jegyzetfüzet | Segédprogramok a jegyzetfüzetek vezérlési folyamatának kezeléséhez (KÍSÉRLETI) |
| titkos kódok | Segédprogramok a titkos kódok jegyzetfüzeteken belüli kihasználásához |
| widgetek | Segédprogramok a jegyzetfüzetek paraméterezéséhez. |
| Api | Segédprogramok az alkalmazás buildjeinek kezeléséhez |
Parancsok súgója
Ha egy segédprogrammodul parancsait és az egyes parancsok rövid leírását szeretné felsorolni, fűzze hozzá .help() a segédprogrammodul neve után. Az alábbi példa a jegyzetfüzet segédprogramhoz elérhető parancsokat sorolja fel:
dbutils.notebook.help()
The notebook module.
exit(value: String): void -> This method lets you exit a notebook with a value
run(path: String, timeoutSeconds: int, arguments: Map): String -> This method runs a notebook and returns its exit value
A parancsok súgójának megjelenítéséhez futtassa a dbutils.<utility-name>.help("<command-name>"). Az alábbi példa a fájlrendszer segédprogramok másolási parancsának súgóját jeleníti meg, dbutils.fs.cp:
dbutils.fs.help("cp")
/**
* Copies a file or directory, possibly across FileSystems.
*
* Example: cp("/mnt/my-folder/a", "dbfs:/a/b")
*
* @param from FileSystem URI of the source file or directory
* @param to FileSystem URI of the destination file or directory
* @param recurse if true, all files and directories will be recursively copied
* @return true if all files were successfully copied
*/
cp(from: java.lang.String, to: java.lang.String, recurse: boolean = false): boolean
Adat segédprogram (dbutils.data)
Fontos
Ez a funkció a nyilvános előzetes verzióban érhető el.
Feljegyzés
Elérhető a Databricks Runtime 9.0 és újabb verziókban.
Az adat segédprogram lehetővé teszi az adathalmazok megértését és a velük való interakciót.
Az alábbi táblázat a segédprogramhoz elérhető parancsokat sorolja fel, amelyeket a dbutils.data.help()használatával lekérhet.
| Parancs | Leírás |
|---|---|
| összegez | Spark DataFrame összegzése és a statisztikák vizualizációja a gyors elemzésekhez |
összegző parancs (dbutils.data.summarize)
Feljegyzés
Ez a funkció a nyilvános előzetes verzióban érhető el.
summarize(df: Object, precise: boolean): void
Kiszámítja és megjeleníti az Apache Spark DataFrame vagy a pandas DataFrame összesített statisztikáit. Ez a parancs Python, Scala és R esetén érhető el.
Fontos
Ez a parancs elemzi a DataFrame teljes tartalmát. A parancs nagyon nagy méretű DataFrame-ekhez való futtatása nagyon költséges lehet.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.data.help("summarize")
A Databricks Runtime 10.4 LTS és újabb verzióiban a további precise paraméter használatával módosíthatja a kiszámított statisztikák pontosságát.
- Ha
precisehamis (alapértelmezett) értékre van állítva, néhány visszaadott statisztika a futási idő csökkentésére vonatkozó közelítéseket tartalmaz.- A kategorikus oszlopok eltérő értékeinek száma ~5%-os relatív hibát okozhat a magas számosságú oszlopok esetében.
- A gyakori értékek száma akár 0,01%-os hibát is okozhat, ha a különböző értékek száma meghaladja az 10000-et.
- A hisztogramok és a percentilisbecslések akár 0,01%-os hibát is okozhatnak a sorok teljes számához képest.
- Ha
preciseigaz értékre van állítva, a statisztikák nagyobb pontossággal lesznek kiszámítva. A numerikus oszlopok hisztogramjai és percentilisei kivételével minden statisztika pontos.- A hisztogramok és a percentilisbecslések legfeljebb 0,0001%-os hibát okozhatnak a sorok teljes számához képest.
Az adatösszesítő kimenet tetején található elemleírás az aktuális futtatás módját jelzi.
Példa
Ez a példa az Apache Spark DataFrame összesített statisztikáit jeleníti meg, alapértelmezés szerint engedélyezett közelítésekkel. Az eredmények megtekintéséhez futtassa ezt a parancsot egy jegyzetfüzetben. Ez a példa mintaadatkészleteken alapul.
Python
df = spark.read.format('csv').load(
'/databricks-datasets/Rdatasets/data-001/csv/ggplot2/diamonds.csv',
header=True,
inferSchema=True
)
dbutils.data.summarize(df)
R
df <- read.df("/databricks-datasets/Rdatasets/data-001/csv/ggplot2/diamonds.csv", source = "csv", header="true", inferSchema = "true")
dbutils.data.summarize(df)
Scala
val df = spark.read.format("csv")
.option("inferSchema", "true")
.option("header", "true")
.load("/databricks-datasets/Rdatasets/data-001/csv/ggplot2/diamonds.csv")
dbutils.data.summarize(df)
A vizualizáció SI-jelölést használ a 0,01-nél kisebb vagy 10000-nél nagyobb numerikus értékek tömör megjelenítéséhez. A numerikus érték 1.25e-15 például a következőképpen jelenik meg 1.25f. Egy kivétel: a megjelenítés a "B" helyett a "1.0e9" (G) értéket használja.
Fájlrendszer segédprogram (dbutils.fs)
A fájlrendszer-kezelő segédprogram lehetővé teszi számodra, hogy hozzáférj a következőhöz: Mi az a DBFS?. A munkaterületi fájlokeléréséhez használjon olyan rendszerhéjparancsokat, mint a %sh ls, mivel vannak bizonyos korlátozások a dbutils.fs parancsok munkaterületi fájlokkal való használatakor.
Figyelmeztetés
A Python-implementáció az összes dbutils.fs metódushoz a snake_case használja kulcsszóformázáshoz a camelCase helyett.
A dbutils.fs.help() például a következőhöz tartozó lehetőséget extraConfigsdbutils.fs.mount()jeleníti meg: A Pythonban azonban a kulcsszót extra_configshasználná.
Az alábbi táblázat a segédprogramhoz elérhető parancsokat sorolja fel, amelyeket a dbutils.fs.help()használatával lekérhet.
| Parancs | Leírás |
|---|---|
| Cp | Fájl vagy könyvtár másolása, esetleg fájlrendszerek között |
| fej | Az adott fájl első "max_bytes" bájtját adja vissza UTF-8-ban kódolt sztringként. |
| Ls | Címtár tartalmának listázása |
| mkdirs | Létrehozza az adott könyvtárat, ha nem létezik, és létrehozza a szükséges szülőkönyvtárakat is |
| szerelés | A megadott forráskönyvtár csatlakoztatása a DBFS-be az adott csatlakoztatási ponton |
| rögzítők | Információkat jelenít meg arról, hogy mi van csatlakoztatva a DBFS-ben |
| Mv | Fájl vagy könyvtár áthelyezése, esetleg fájlrendszerek között. |
| helyezze | Az adott sztringet egy UTF-8 kóddal kódolt fájlba írja ki |
| refreshMounts | Kényszeríti a fürt összes gépét a csatlakoztatási gyorsítótár frissítésére, biztosítva, hogy megkapják a legfrissebb információkat |
| mikrométer | Fájl vagy könyvtár eltávolítása |
| leválaszt | DBFS-csatlakoztatási pont törlése |
| frissítésTárolás | Hasonló a csatlakoztatáshoz(), de egy meglévő csatlakoztatási pontot frissít ahelyett, hogy újat hoz létre |
Borravaló
Jegyzetfüzetekben a %fs magic parancsot használhatja a DBFS eléréséhez. Például %fs ls /Volumes/main/default/my-volume/ ugyanaz, mint dbutils.fs.ls("/Volumes/main/default/my-volume/"). Tekintse meg a varázsparancsokat.
cp parancs (dbutils.fs.cp)
cp(from: String, to: String, recurse: boolean = false): boolean
Fájl vagy könyvtár másolása, esetleg fájlrendszerek között.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.fs.help("cp")
Példa
Ez a példa a névvel ellátott data.csv/Volumes/main/default/my-volume/new-data.csv fájlt ugyanabba a kötetbe másolja.
Python
dbutils.fs.cp("/Volumes/main/default/my-volume/data.csv", "/Volumes/main/default/my-volume/new-data.csv")
# Out[4]: True
R
dbutils.fs.cp("/Volumes/main/default/my-volume/data.csv", "/Volumes/main/default/my-volume/new-data.csv")
# [1] TRUE
Scala
dbutils.fs.cp("/Volumes/main/default/my-volume/data.csv", "/Volumes/main/default/my-volume/new-data.csv")
// res3: Boolean = true
head command (dbutils.fs.head)
head(file: String, max_bytes: int = 65536): String
A megadott maximális bájtszámot adja vissza az adott fájlban. A bájtok UTF-8 kódolású sztringként lesznek visszaadva.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.fs.help("head")
Példa
Ez a példa a fájl data.csv/Volumes/main/default/my-volume/első 25 bájtját jeleníti meg.
Python
dbutils.fs.head("/Volumes/main/default/my-volume/data.csv", 25)
# [Truncated to first 25 bytes]
# Out[12]: 'Year,First Name,County,Se'
R
dbutils.fs.head("/Volumes/main/default/my-volume/data.csv", 25)
# [1] "Year,First Name,County,Se"
Scala
dbutils.fs.head("/Volumes/main/default/my-volume/data.csv", 25)
// [Truncated to first 25 bytes]
// res4: String =
// "Year,First Name,County,Se"
ls parancs (dbutils.fs.ls)
ls(dir: String): Seq
Egy könyvtár tartalmát sorolja fel.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.fs.help("ls")
Példa
Ez a példa a tartalommal /Volumes/main/default/my-volume/kapcsolatos információkat jeleníti meg. A modificationTime mező a Databricks Runtime 10.4 LTS és újabb verziókban érhető el. Az R-ben modificationTime sztringként lesz visszaadva.
Python
dbutils.fs.ls("/Volumes/main/default/my-volume/")
# Out[13]: [FileInfo(path='dbfs:/Volumes/main/default/my-volume/data.csv', name='data.csv', size=2258987, modificationTime=1711357839000)]
R
dbutils.fs.ls("/Volumes/main/default/my-volume/")
# For prettier results from dbutils.fs.ls(<dir>), please use `%fs ls <dir>`
# [[1]]
# [[1]]$path
# [1] "/Volumes/main/default/my-volume/data.csv"
# [[1]]$name
# [1] "data.csv"
# [[1]]$size
# [1] 2258987
# [[1]]$isDir
# [1] FALSE
# [[1]]$isFile
# [1] TRUE
# [[1]]$modificationTime
# [1] "1711357839000"
Scala
dbutils.fs.ls("/tmp")
// res6: Seq[com.databricks.backend.daemon.dbutils.FileInfo] = WrappedArray(FileInfo(/Volumes/main/default/my-volume/data.csv, 2258987, 1711357839000))
mkdirs parancs (dbutils.fs.mkdirs)
mkdirs(dir: String): boolean
Létrehozza a megadott könyvtárat, ha nem létezik. Emellett létrehozza a szükséges szülőkönyvtárakat is.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.fs.help("mkdirs")
Példa
Ez a példa létrehozza a könyvtárat my-data a /Volumes/main/default/my-volume/ belül.
Python
dbutils.fs.mkdirs("/Volumes/main/default/my-volume/my-data")
# Out[15]: True
R
dbutils.fs.mkdirs("/Volumes/main/default/my-volume/my-data")
# [1] TRUE
Scala
dbutils.fs.mkdirs("/Volumes/main/default/my-volume/my-data")
// res7: Boolean = true
csatlakoztatási parancs (dbutils.fs.mount)
mount(source: String, mountPoint: String, encryptionType: String = "",
owner: String = null, extraConfigs: Map = Map.empty[String, String]): boolean
Csatlakoztatja a megadott forráskönyvtárat a DBFS-be a megadott csatlakoztatási ponton.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.fs.help("mount")
Példa
Python
dbutils.fs.mount(
source = "wasbs://<container-name>@<storage-account-name>.blob.core.windows.net",
mount_point = "/mnt/<mount-name>",
extra_configs = {"<conf-key>":dbutils.secrets.get(scope = "<scope-name>", key = "<key-name>")})
Scala
dbutils.fs.mount(
source = "wasbs://<container-name>@<storage-account-name>.blob.core.windows.net/<directory-name>",
mountPoint = "/mnt/<mount-name>",
extraConfigs = Map("<conf-key>" -> dbutils.secrets.get(scope = "<scope-name>", key = "<key-name>")))
További példakódok: Csatlakozás az Azure Data Lake Storage-hoz és a Blob Storage-hoz.
csatolások parancs (dbutils.fs.mounts)
mounts: Seq
Információkat jelenít meg arról, hogy mi van jelenleg csatlakoztatva a DBFS-ben.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.fs.help("mounts")
Példa
Figyelmeztetés
Az új csatlakozás terjesztéséhez futtassa a dbutils.fs.refreshMounts() parancsot az összes többi működő fürtön. Lásd: refreshMounts parancs (dbutils.fs.refreshMounts).
Python
dbutils.fs.mounts()
Scala
dbutils.fs.mounts()
További példakódok: Csatlakozás az Azure Data Lake Storage-hoz és a Blob Storage-hoz.
mv parancs (dbutils.fs.mv)
mv(from: String, to: String, recurse: boolean = false): boolean
Áthelyez egy fájlt vagy könyvtárat, esetleg fájlrendszerek között. Az áthelyezés egy másolat, amelyet törlés követ, még a fájlrendszereken belüli áthelyezésekhez is.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.fs.help("mv")
Példa
Ez a példa áthelyezi a fájlt rows.csv/Volumes/main/default/my-volume/-ról /Volumes/main/default/my-volume/my-data/-re.
Python
dbutils.fs.mv("/Volumes/main/default/my-volume/rows.csv", "/Volumes/main/default/my-volume/my-data/")
# Out[2]: True
R
dbutils.fs.mv("/Volumes/main/default/my-volume/rows.csv", "/Volumes/main/default/my-volume/my-data/")
# [1] TRUE
Scala
dbutils.fs.mv("/Volumes/main/default/my-volume/rows.csv", "/Volumes/main/default/my-volume/my-data/")
// res1: Boolean = true
put parancs (dbutils.fs.put)
put(file: String, contents: String, overwrite: boolean = false): boolean
A megadott sztringet egy fájlba írja. A sztring UTF-8 kódolású.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.fs.help("put")
Példa
Ez a példa a(z) Hello, Databricks! karakterláncot a(z) hello.txt nevű fájlba írja /Volumes/main/default/my-volume/-ben. Ha a fájl létezik, a program felülírja.
Python
dbutils.fs.put("/Volumes/main/default/my-volume/hello.txt", "Hello, Databricks!", True)
# Wrote 2258987 bytes.
# Out[6]: True
R
dbutils.fs.put("/Volumes/main/default/my-volume/hello.txt", "Hello, Databricks!", TRUE)
# [1] TRUE
Scala
dbutils.fs.put("/Volumes/main/default/my-volume/hello.txt", "Hello, Databricks!", true)
// Wrote 2258987 bytes.
// res2: Boolean = true
refreshMounts parancs (dbutils.fs.refreshMounts)
refreshMounts: boolean
Kényszeríti a fürt összes gépét a csatlakoztatási gyorsítótár frissítésére, biztosítva, hogy megkapják a legfrissebb információkat.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.fs.help("refreshMounts")
Példa
Python
dbutils.fs.refreshMounts()
Scala
dbutils.fs.refreshMounts()
További kódpéldákért lásd: Csatlakozás az Azure Data Lake Storage-hoz és a Blob Storage-hoz.
rm parancs (dbutils.fs.rm)
rm(dir: String, recurse: boolean = false): boolean
Eltávolít egy fájlt vagy könyvtárat, és szükség esetén az összes tartalmát. Ha egy fájl meg van adva, a recurse paraméter figyelmen kívül lesz hagyva. Ha egy könyvtár meg van adva, hiba történik, ha recurse le van tiltva, és a címtár nem üres.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.fs.help("rm")
Példa
Ez a példa eltávolítja a teljes könyvtárat /Volumes/main/default/my-volume/my-data/ , beleértve annak tartalmát is.
Python
dbutils.fs.rm("/Volumes/main/default/my-volume/my-data/", True)
# Out[8]: True
R
dbutils.fs.rm("/Volumes/main/default/my-volume/my-data/", TRUE)
# [1] TRUE
Scala
dbutils.fs.rm("/Volumes/main/default/my-volume/my-data/", true)
// res6: Boolean = true
csatolás megszüntetési parancs (dbutils.fs.unmount)
unmount(mountPoint: String): boolean
DbFS-csatlakoztatási pont törlése.
Figyelmeztetés
A hibák elkerülése érdekében soha ne módosítsa a csatlakoztatási pontot, amíg más feladatok olvasnak vagy írnak hozzá. A csatlakoztatás módosítása után mindig futtassa dbutils.fs.refreshMounts() az összes többi futó fürtön a csatlakoztatási frissítések propagálásához. Lásd: refreshMounts parancs (dbutils.fs.refreshMounts).
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.fs.help("unmount")
Példa
dbutils.fs.unmount("/mnt/<mount-name>")
További példakódok: Csatlakozás az Azure Data Lake Storage-hoz és a Blob Storage-hoz.
updateMount parancs (dbutils.fs.updateMount)
updateMount(source: String, mountPoint: String, encryptionType: String = "",
owner: String = null, extraConfigs: Map = Map.empty[String, String]): boolean
Hasonló a dbutils.fs.mount parancshoz, de egy meglévő csatlakoztatási pontot frissít ahelyett, hogy újat hoz létre. Hibát ad vissza, ha a csatlakoztatási pont nincs jelen.
Figyelmeztetés
A hibák elkerülése érdekében soha ne módosítsa a csatlakoztatási pontot, amíg más feladatok olvasnak vagy írnak hozzá. A csatlakoztatás módosítása után mindig futtassa dbutils.fs.refreshMounts() az összes többi futó fürtön a csatlakoztatási frissítések propagálásához. Lásd: refreshMounts parancs (dbutils.fs.refreshMounts).
Ez a parancs a Databricks Runtime 10.4 LTS és újabb verziókban érhető el.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.fs.help("updateMount")
Példa
Python
dbutils.fs.updateMount(
source = "wasbs://<container-name>@<storage-account-name>.blob.core.windows.net",
mount_point = "/mnt/<mount-name>",
extra_configs = {"<conf-key>":dbutils.secrets.get(scope = "<scope-name>", key = "<key-name>")})
Scala
dbutils.fs.updateMount(
source = "wasbs://<container-name>@<storage-account-name>.blob.core.windows.net/<directory-name>",
mountPoint = "/mnt/<mount-name>",
extraConfigs = Map("<conf-key>" -> dbutils.secrets.get(scope = "<scope-name>", key = "<key-name>")))
Feladatok segédprogram (dbutils.jobs)
Segédprogramokat biztosít a feladatok funkcióinak használatához.
Feljegyzés
Ez a segédprogram csak Pythonhoz érhető el.
Az alábbi táblázat a segédprogram elérhető moduljait sorolja fel, amelyeket dbutils.jobs.help()használatával lehet lekérni.
| Submodule | Leírás |
|---|---|
| feladatértékek | Segédprogramokat biztosít a feladatok tevékenységértékeinek kihasználásához |
taskValues részfunkció (dbutils.jobs.taskValues)
Feljegyzés
Ez a segédprogram csak Pythonhoz áll rendelkezésre.
Parancsokat biztosít a feladatok tevékenységértékeinek kihasználásához.
Ezzel az alművelettel tetszőleges értékeket állíthat be és kérhet le egy feladat futtatása során. Ezeket az értékeket feladatértékeknek nevezzük. Bármely tevékenység lekérheti a felsőbb rétegbeli tevékenységek által beállított értékeket, és beállíthatja az alsóbb rétegbeli tevékenységekhez tartozó értékeket.
Minden tevékenységérték egyedi kulccsal rendelkezik ugyanazon a tevékenységen belül. Ezt az egyedi kulcsot a tevékenység értékének kulcsának nevezzük. A tevékenységérték a tevékenység nevével és a tevékenység értékének kulcsával érhető el. Ezt arra használhatja, hogy egy feladatról egy másik feladatra továbbítson adatokat ugyanazon feladatfuttatás során. Például azonosítókat vagy metrikákat, például egy gépi tanulási modell kiértékelési adatait adhat át a feladatfuttatás különböző tevékenységei között.
Az alábbi táblázat felsorolja az altartalmához elérhető parancsokat, amelyeket a dbutils.jobs.taskValues.help()használatával lehet lekérni.
| Parancs | Leírás |
|---|---|
| szerezze meg | Lekéri a megadott feladatérték tartalmát a jelenlegi munkamenet futásában. |
| beállítása | Tevékenységérték beállítása vagy frissítése. Egy feladatfuttatáshoz legfeljebb 250 tevékenységértéket állíthat be. |
get parancs (dbutils.jobs.taskValues.get)
Feljegyzés
Ez a parancs csak Pythonhoz érhető el.
A Databricks Runtime 10.4 és korábbi verzióiban, ha a get nem találja a feladatot, akkor Py4JJavaError-t emel ki ahelyett, hogy egy ValueError.
get(taskKey: String, key: String, default: int, debugValue: int): Seq
Lekéri a megadott feladatérték tartalmát a jelenlegi munkamenet futásában.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.jobs.taskValues.help("get")
Példa
Példa:
dbutils.jobs.taskValues.get(taskKey = "my-task", \
key = "my-key", \
default = 7, \
debugValue = 42)
Az előző példában:
-
taskKeya tevékenység értékét beállító tevékenység neve. Ha a parancs nem találja ezt a feladatot, megjelenik egyValueError. -
keya feladat értékének a set paranccsal (dbutils.jobs.taskValues.set) beállított kulcsának neve. Ha a parancs nem találja ennek a tevékenységértéknek a kulcsát, a rendszer felvesz egyValueErrorértéket (hacsak nincsdefaultmegadva). -
defaultegy nem kötelező érték, amely akkor lesz visszaadva, hakeynem található.defaultnem lehetNone. -
debugValuenem kötelező érték, amelyet akkor ad vissza a rendszer, ha egy feladaton kívül futó jegyzetfüzetből próbálja lekérni a feladat értékét. Ez hasznos lehet a hibakeresés során, amikor manuálisan szeretné futtatni a notebookot, és valamilyen értéket szeretne visszaadni az alapértelmezettTypeErrorhelyett.debugValuenem lehetNone.
Ha egy feladaton kívül futó jegyzetfüzetből próbál feladatértéket lekérni, ez a parancs alapértelmezés szerint előhoz egy TypeError értéket. Ha azonban az debugValue argumentum meg van adva a parancsban, a függvény az érték értékét debugValue adja vissza ahelyett, hogy egy értéket emelne ki TypeError.
set parancs (dbutils.jobs.taskValues.set)
Feljegyzés
Ez a parancs csak Pythonhoz érhető el.
set(key: String, value: String): boolean
Tevékenységérték beállítása vagy frissítése. Egy feladatfuttatáshoz legfeljebb 250 tevékenységértéket állíthat be.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.jobs.taskValues.help("set")
Példa
Néhány példa:
dbutils.jobs.taskValues.set(key = "my-key", \
value = 5)
dbutils.jobs.taskValues.set(key = "my-other-key", \
value = "my other value")
Az előző példákban:
-
keya tevékenység értékének kulcsa. Ennek a kulcsnak egyedinek kell lennie a tevékenységhez. Vagyis ha két különböző tevékenység egy tevékenységértéket állít be kulccsalK, akkor két különböző tevékenységértékről van szó, amelyek ugyanazt a kulcsotKhasználják. -
valuea tevékenységérték kulcsának értéke. Ennek a parancsnak képesnek kell lennie az érték belső JSON formátumban való megjelenítésére. Az érték JSON-ábrázolásának mérete nem haladhatja meg a 48 KiB-t.
Ha egy feladaton kívül futó jegyzetfüzetből próbál feladatértéket beállítani, ez a parancs nem tesz semmit.
Könyvtár segédprogram (dbutils.library)
Az dbutils.library almodul legtöbb metódusa elavult. Lásd: Library segédprogram (dbutils.library) (régi).
Előfordulhat, hogy programozott módon újra kell indítania a Python-folyamatot az Azure Databricksben, hogy a helyileg telepített vagy frissített kódtárak megfelelően működjenek a Python-kernelben az aktuális SparkSession esetében. Ehhez futtassa a dbutils.library.restartPython parancsot. Lásd: A Python-folyamat újraindítása az Azure Databricksben.
Notebook segédprogram (dbutils.notebook)
A jegyzetfüzet segédprogram lehetővé teszi a jegyzetfüzetek összefűzését és az eredményeik alapján történő cselekvést. Lásd jegyzetfüzetek vezénylése és a kód modularizálása a jegyzetfüzetekben.
Az alábbi táblázat a segédprogramhoz elérhető parancsokat sorolja fel, amelyeket a dbutils.notebook.help()használatával lekérhet.
| Parancs | Leírás |
|---|---|
| kilépés | Kilép egy értékkel rendelkező jegyzetfüzetből |
| fut | Notebook futtatása és kilépési értékének visszaadása. |
kilépési parancs (dbutils.notebook.exit)
exit(value: String): void
Kilép egy értékekkel rendelkező jegyzetfüzetből.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.notebook.help("exit")
Példa
A példa Exiting from My Other Notebook értékkel lép ki a jegyzetfüzetből.
Python
dbutils.notebook.exit("Exiting from My Other Notebook")
# Notebook exited: Exiting from My Other Notebook
R
dbutils.notebook.exit("Exiting from My Other Notebook")
# Notebook exited: Exiting from My Other Notebook
Scala
dbutils.notebook.exit("Exiting from My Other Notebook")
// Notebook exited: Exiting from My Other Notebook
Feljegyzés
Ha a futtatás olyan lekérdezéssel rendelkezik, amely a háttérben futó strukturált streameléssel rendelkezik, a hívás dbutils.notebook.exit() nem szakítja meg a futtatás befejezését. A futtatás addig folytatódik, amíg a lekérdezés a háttérben fut. A háttérben futó lekérdezés leállításához kattintson a Mégse gombra a lekérdezés cellájában, vagy futtassa a parancsotquery.stop(). Ha a lekérdezés leáll, a futtatás leállhat a következővel dbutils.notebook.exit(): .
futtatási parancs (dbutils.notebook.run)
run(path: String, timeoutSeconds: int, arguments: Map): String
Futtat egy jegyzetfüzetet, és visszaadja a kilépési értékét. A jegyzetfüzet az aktuális fürtben fog futni.
Feljegyzés
A parancsból run visszaadott sztringérték maximális hossza 5 MB. Lásd: Egyetlen futtatás kimenetének lekérése (GET /jobs/runs/get-output).
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.notebook.help("run")
Példa
Ez a példa egy, a hívó jegyzetfüzetével azonos helyen lévő My Other Notebook jegyzetfüzetet futtat. Az említett jegyzetfüzet a kódsorra, dbutils.notebook.exit("Exiting from My Other Notebook") végződik. Ha a hívott jegyzetfüzet nem fejeződik be 60 másodpercen belül, a rendszer kivételt jelez.
Python
dbutils.notebook.run("My Other Notebook", 60)
# Out[14]: 'Exiting from My Other Notebook'
Scala
dbutils.notebook.run("My Other Notebook", 60)
// res2: String = Exiting from My Other Notebook
Titkos kulcsok segédprogram (dbutils.secrets)
A titkos kulcsok segédprogram lehetővé teszi a bizalmas hitelesítő adatok tárolását és elérését anélkül, hogy a jegyzetfüzetekben láthatóvá tenné őket. Lásd: Titkos kódok kezelése és 3. lépés: A titkos kódok használata egy jegyzetfüzetben.
Az alábbi táblázat a segédprogramhoz elérhető parancsokat sorolja fel, amelyeket a dbutils.secrets.help()használatával lekérhet.
| Parancs | Leírás |
|---|---|
| szerezze meg | Lekéri egy titkos érték karakterláncát a hatókörrel és a kulccsal |
| getBytes | Lekéri egy titkos érték bájtos ábrázolását megadott hatókörrel és kulccsal |
| lista | Egy hatókör titkos metaadatainak listázása |
| listScopes | Titkos hatóköri listák |
get parancs (dbutils.secrets.get)
get(scope: String, key: String): String
A megadott hatókörhöz és kulcshoz tartozó titkos érték karaktersorozatát lekéri.
Figyelmeztetés
A rendszergazdák, a titkos kódok létrehozói és az engedéllyel rendelkező felhasználók elolvashatják az Azure Databricks titkos kulcsait. Bár az Azure Databricks törekszik a jegyzetfüzetekben esetleg megjelenő titkos értékek újrakódosítására, nem lehet megakadályozni, hogy az ilyen felhasználók titkos kulcsokat olvasnak. További információért tekintse meg a titkos szerkesztést.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.secrets.help("get")
Példa
Ez a példa a my-scope nevű hatókör és a my-key nevű kulcs titkos értékének szöveges ábrázolását adja meg.
Python
dbutils.secrets.get(scope="my-scope", key="my-key")
# Out[14]: '[REDACTED]'
R
dbutils.secrets.get(scope="my-scope", key="my-key")
# [1] "[REDACTED]"
Scala
dbutils.secrets.get(scope="my-scope", key="my-key")
// res0: String = [REDACTED]
getBytes parancs (dbutils.secrets.getBytes)
getBytes(scope: String, key: String): byte[]
Lekéri a titkos érték bájtokbeli ábrázolását a megadott hatókör és kulcs alapján.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.secrets.help("getBytes")
Példa
Ez a példa lekéri a a1!b2@c3# nevű hatókör és a my-scope nevű kulcs titkos értékének bájtos ábrázolását (ebben a példában my-key).
Python
dbutils.secrets.getBytes(scope="my-scope", key="my-key")
# Out[1]: b'a1!b2@c3#'
R
dbutils.secrets.getBytes(scope="my-scope", key="my-key")
# [1] 61 31 21 62 32 40 63 33 23
Scala
dbutils.secrets.getBytes(scope="my-scope", key="my-key")
// res1: Array[Byte] = Array(97, 49, 33, 98, 50, 64, 99, 51, 35)
list parancs (dbutils.secrets.list)
list(scope: String): Seq
A megadott hatókörben lévő titkos kódok metaadatait sorolja fel.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.secrets.help("list")
Példa
Ez a példa a névvel ellátott my-scopehatókör titkos kulcsainak metaadatait sorolja fel.
Python
dbutils.secrets.list("my-scope")
# Out[10]: [SecretMetadata(key='my-key')]
R
dbutils.secrets.list("my-scope")
# [[1]]
# [[1]]$key
# [1] "my-key"
Scala
dbutils.secrets.list("my-scope")
// res2: Seq[com.databricks.dbutils_v1.SecretMetadata] = ArrayBuffer(SecretMetadata(my-key))
listScopes parancs (dbutils.secrets.listScopes)
listScopes: Seq
Felsorolja az elérhető hatóköröket.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.secrets.help("listScopes")
Példa
Ez a példa az elérhető hatóköröket sorolja fel.
Python
dbutils.secrets.listScopes()
# Out[14]: [SecretScope(name='my-scope')]
R
dbutils.secrets.listScopes()
# [[1]]
# [[1]]$name
# [1] "my-scope"
Scala
dbutils.secrets.listScopes()
// res3: Seq[com.databricks.dbutils_v1.SecretScope] = ArrayBuffer(SecretScope(my-scope))
Widgets segédprogram (dbutils.widgets)
A widgetek segédprogram lehetővé teszi a jegyzetfüzetek paraméterezését. Lásd a Databricks-vezérlőket.
Az alábbi táblázat a segédprogramhoz elérhető parancsokat sorolja fel, amelyeket a dbutils.widgets.help()használatával lekérhet.
| Parancs | Leírás |
|---|---|
| kombinált mező | Kombinált lista beviteli mező létrehozása adott névvel, alapértelmezett értékkel és választási lehetőségekkel |
| legördülő menü | Létrehoz egy legördülő beviteli vezérlőt a megadott névvel, alapértelmezett értékkel és választási lehetőségekkel |
| szerezze meg | Egy bemeneti widget aktuális értékének lekérése |
| getAll | Lekéri az összes widget nevét és értékeit tartalmazó térképet |
| getArgument | Elavult. Egyenértékű a beszerzéssel |
| többszörös kijelölés | Több kijelöléses beviteli vezérlő létrehozása adott névvel, alapértelmezett értékkel és választási lehetőségekkel |
| eltávolítása | Beviteli vezérlő eltávolítása a jegyzetfüzetből |
| távolítsa el mindet | Eltávolítja a jegyzetfüzet összes widgetét |
| szöveg | Szövegbeviteli vezérlő létrehozása adott névvel és alapértelmezett értékkel |
combobox parancs (dbutils.widgets.combobox)
combobox(name: String, defaultValue: String, choices: Seq, label: String): void
Létrehoz és megjelenít egy kombinált lista widgetet a megadott programozott névvel, alapértelmezett értékkel, választási lehetőségekkel és opcionális címkével.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.widgets.help("combobox")
Példa
Ez a példa egy fruits_combobox programozási névvel ellátott kombinált lista widgetet hoz létre és jelenít meg. Lehetőséget kínál apple, banana, coconut és dragon fruit, és a kezdeti érték banana-ra van állítva. Ez a kombinált lista widget egy kísérő címkével Fruitsrendelkezik. Ez a példa a legördülő lista widget kezdeti értékének kiírásával fejeződik be. banana
Python
dbutils.widgets.combobox(
name='fruits_combobox',
defaultValue='banana',
choices=['apple', 'banana', 'coconut', 'dragon fruit'],
label='Fruits'
)
print(dbutils.widgets.get("fruits_combobox"))
# banana
R
dbutils.widgets.combobox(
name='fruits_combobox',
defaultValue='banana',
choices=list('apple', 'banana', 'coconut', 'dragon fruit'),
label='Fruits'
)
print(dbutils.widgets.get("fruits_combobox"))
# [1] "banana"
Scala
dbutils.widgets.combobox(
"fruits_combobox",
"banana",
Array("apple", "banana", "coconut", "dragon fruit"),
"Fruits"
)
print(dbutils.widgets.get("fruits_combobox"))
// banana
SQL
CREATE WIDGET COMBOBOX fruits_combobox DEFAULT "banana" CHOICES SELECT * FROM (VALUES ("apple"), ("banana"), ("coconut"), ("dragon fruit"))
SELECT :fruits_combobox
-- banana
dropdown parancs (dbutils.widgets.dropdown)
dropdown(name: String, defaultValue: String, choices: Seq, label: String): void
Létrehoz és megjelenít egy legördülő vezérlőt a megadott programozott névvel, alapértelmezett értékkel, választási lehetőségekkel és opcionális címkével.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.widgets.help("dropdown")
Példa
Ez a példa egy programozott nevű toys_dropdownlegördülő vezérlőt hoz létre és jelenít meg. Lehetőséget kínál alphabet blocks, basketball, cape és doll, és a kezdeti érték basketball-ra van állítva. Ez a legördülő vezérlő egy kísérő címkével Toysrendelkezik. Ez a példa a legördülő vezérlő kezdeti értékének nyomtatásával fejeződik be. basketball
Python
dbutils.widgets.dropdown(
name='toys_dropdown',
defaultValue='basketball',
choices=['alphabet blocks', 'basketball', 'cape', 'doll'],
label='Toys'
)
print(dbutils.widgets.get("toys_dropdown"))
# basketball
R
dbutils.widgets.dropdown(
name='toys_dropdown',
defaultValue='basketball',
choices=list('alphabet blocks', 'basketball', 'cape', 'doll'),
label='Toys'
)
print(dbutils.widgets.get("toys_dropdown"))
# [1] "basketball"
Scala
dbutils.widgets.dropdown(
"toys_dropdown",
"basketball",
Array("alphabet blocks", "basketball", "cape", "doll"),
"Toys"
)
print(dbutils.widgets.get("toys_dropdown"))
// basketball
SQL
CREATE WIDGET DROPDOWN toys_dropdown DEFAULT "basketball" CHOICES SELECT * FROM (VALUES ("alphabet blocks"), ("basketball"), ("cape"), ("doll"))
SELECT :toys_dropdown
-- basketball
get parancs (dbutils.widgets.get)
get(name: String): String
Lekéri a widget aktuális értékét a megadott programozott neve alapján. Ez a programozott név a következő lehet:
- Egy egyéni widget neve a jegyzetfüzetben, például
fruits_comboboxtoys_dropdown. - A jegyzetfüzethez egy jegyzetfüzet-feladat részeként megadott egyéni paraméter neve, például
namevagyage. További információkért tekintse meg a jegyzetfüzet-tevékenységek paramétereinek lefedettségét a feladatok felhasználói felületén vagy a mezőt az új feladat futtatásának indítása (notebook_params) műveletnél a Jobs API-ban.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.widgets.help("get")
Példa
Ez a példa a programozott nevű fruits_comboboxwidget értékét adja meg.
Python
dbutils.widgets.get('fruits_combobox')
# banana
R
dbutils.widgets.get('fruits_combobox')
# [1] "banana"
Scala
dbutils.widgets.get("fruits_combobox")
// res6: String = banana
SQL
SELECT :fruits_combobox
-- banana
Ez a példa a programozott nevet agetartalmazó jegyzetfüzet-tevékenységparaméter értékét adja meg. Ez a paraméter a 35 kapcsolódó jegyzetfüzet-feladat futtatásakor lett beállítva.
Python
dbutils.widgets.get('age')
# 35
R
dbutils.widgets.get('age')
# [1] "35"
Scala
dbutils.widgets.get("age")
// res6: String = 35
SQL
SELECT :age
-- 35
getAll parancs (dbutils.widgets.getAll)
getAll: map
Lekéri az összes aktuális widgetnevet és értéket. Ez különösen hasznos lehet a widgetértékek lekérdezéshez való gyors továbbításához spark.sql() .
Ez a parancs a Databricks Runtime 13.3 LTS-ben és újabb verziókban érhető el. Csak Python és Scala esetén érhető el.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.widgets.help("getAll")
Példa
Ez a példa lekéri a widgetértékek térképét, és paraméterargumentumként adja át egy Spark SQL-lekérdezésben.
Python
df = spark.sql("SELECT * FROM table where col1 = :param", dbutils.widgets.getAll())
df.show()
# Query output
Scala
val df = spark.sql("SELECT * FROM table where col1 = :param", dbutils.widgets.getAll())
df.show()
// res6: Query output
getArgument parancs (dbutils.widgets.getArgument)
getArgument(name: String, optional: String): String
Lekéri a widget aktuális értékét a megadott programozott neve alapján. Ha a widget nem létezik, opcionális üzenet küldhető vissza.
Feljegyzés
Ez a parancs elavult. Ehelyett használja a dbutils.widgets.get parancsot .
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.widgets.help("getArgument")
Példa
Ez a példa a programozott nevű fruits_comboboxwidget értékét adja meg. Ha ez a widget nem létezik, a rendszer visszaadja az üzenetet Error: Cannot find fruits combobox .
Python
dbutils.widgets.getArgument('fruits_combobox', 'Error: Cannot find fruits combobox')
# Deprecation warning: Use dbutils.widgets.text() or dbutils.widgets.dropdown() to create a widget and dbutils.widgets.get() to get its bound value.
# Out[3]: 'banana'
R
dbutils.widgets.getArgument('fruits_combobox', 'Error: Cannot find fruits combobox')
# Deprecation warning: Use dbutils.widgets.text() or dbutils.widgets.dropdown() to create a widget and dbutils.widgets.get() to get its bound value.
# [1] "banana"
Scala
dbutils.widgets.getArgument("fruits_combobox", "Error: Cannot find fruits combobox")
// command-1234567890123456:1: warning: method getArgument in trait WidgetsUtils is deprecated: Use dbutils.widgets.text() or dbutils.widgets.dropdown() to create a widget and dbutils.widgets.get() to get its bound value.
// dbutils.widgets.getArgument("fruits_combobox", "Error: Cannot find fruits combobox")
// ^
// res7: String = banana
multiselect parancs (dbutils.widgets.multiselect)
multiselect(name: String, defaultValue: String, choices: Seq, label: String): void
Létrehoz és megjelenít egy több kijelölési vezérlőt a megadott programozott névvel, alapértelmezett értékkel, választási lehetőségekkel és opcionális címkével.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.widgets.help("multiselect")
Példa
Ez a példa létrehoz és megjelenít egy többkijelölős vezérlőt a programozott névvel days_multiselect. A választási lehetőségeket Monday és Sunday között kínálja, és kezdeti értékként Tuesday van beállítva. Ez a multiselect widget egy kísérő címkével Days of the Weekrendelkezik. Ez a példa a multiselect widget Tuesdaykezdeti értékének nyomtatásával fejeződik be.
Python
dbutils.widgets.multiselect(
name='days_multiselect',
defaultValue='Tuesday',
choices=['Monday', 'Tuesday', 'Wednesday', 'Thursday',
'Friday', 'Saturday', 'Sunday'],
label='Days of the Week'
)
print(dbutils.widgets.get("days_multiselect"))
# Tuesday
R
dbutils.widgets.multiselect(
name='days_multiselect',
defaultValue='Tuesday',
choices=list('Monday', 'Tuesday', 'Wednesday', 'Thursday',
'Friday', 'Saturday', 'Sunday'),
label='Days of the Week'
)
print(dbutils.widgets.get("days_multiselect"))
# [1] "Tuesday"
Scala
dbutils.widgets.multiselect(
"days_multiselect",
"Tuesday",
Array("Monday", "Tuesday", "Wednesday", "Thursday",
"Friday", "Saturday", "Sunday"),
"Days of the Week"
)
print(dbutils.widgets.get("days_multiselect"))
// Tuesday
SQL
CREATE WIDGET MULTISELECT days_multiselect DEFAULT "Tuesday" CHOICES SELECT * FROM (VALUES ("Monday"), ("Tuesday"), ("Wednesday"), ("Thursday"), ("Friday"), ("Saturday"), ("Sunday"))
SELECT :days_multiselect
-- Tuesday
parancs eltávolítása (dbutils.widgets.remove)
remove(name: String): void
Eltávolítja a widgetet a megadott programozott névvel.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.widgets.help("remove")
Fontos
Amikor egy widget eltávolítására szolgáló parancsot ad hozzá, nem adhat hozzá egy következő parancsot ugyanabban a cellában widget létrehozására. A widgetet egy másik cellában kell létrehoznia.
Példa
Ez a példa eltávolítja a programozott nevű widgetet fruits_combobox.
Python
dbutils.widgets.remove('fruits_combobox')
R
dbutils.widgets.remove('fruits_combobox')
Scala
dbutils.widgets.remove("fruits_combobox")
SQL
REMOVE WIDGET fruits_combobox
removeAll parancs (dbutils.widgets.removeAll)
removeAll: void
Eltávolítja az összes widgetet a jegyzetfüzetből.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.widgets.help("removeAll")
Fontos
Ha parancsot ad az összes widget eltávolítására, nem adhat hozzá további parancsot, amely bármilyen widgetet hozna létre ugyanabban a cellában. A widgeteket egy másik cellában kell létrehoznia.
Példa
Ez a példa eltávolítja az összes widgetet a jegyzetfüzetből.
Python
dbutils.widgets.removeAll()
R
dbutils.widgets.removeAll()
Scala
dbutils.widgets.removeAll()
szöveg parancs (dbutils.widgets.text)
text(name: String, defaultValue: String, label: String): void
Létrehoz és megjelenít egy szöveg widgetet a megadott programozott névvel, alapértelmezett értékkel és opcionális címkével.
A parancs teljes súgójának megjelenítéséhez futtassa a következőt:
dbutils.widgets.help("text")
Példa
Ez a példa egy programozott nevű your_name_textszöveg widgetet hoz létre és jelenít meg. A beállítás a kezdeti értékre Enter your namevan állítva. Ez a szöveg widget egy kísérő címkével Your namerendelkezik. Ez a példa a szöveg widget kezdeti értékének nyomtatásával fejeződik be. Enter your name
Python
dbutils.widgets.text(
name='your_name_text',
defaultValue='Enter your name',
label='Your name'
)
print(dbutils.widgets.get("your_name_text"))
# Enter your name
R
dbutils.widgets.text(
name='your_name_text',
defaultValue='Enter your name',
label='Your name'
)
print(dbutils.widgets.get("your_name_text"))
# [1] "Enter your name"
Scala
dbutils.widgets.text(
"your_name_text",
"Enter your name",
"Your name"
)
print(dbutils.widgets.get("your_name_text"))
// Enter your name
SQL
CREATE WIDGET TEXT your_name_text DEFAULT "Enter your name"
SELECT :your_name_text
-- Enter your name
Databricks Utilities API-kódtár
Fontos
A Databricks Utilities API (dbutils-api) könyvtár elavult. A Databricks a következők egyikét javasolja:
Az alkalmazásfejlesztés felgyorsítása érdekében hasznos lehet az alkalmazások fordítása, összeállítása és tesztelése, mielőtt éles feladatként üzembe helyezené őket. Annak érdekében, hogy a Databricks segédprogramokkal fordíthasson, a Databricks biztosítja a dbutils-api könyvtárat. A kódtárat letöltheti a dbutils-apiDBUtils API webhelyéről a Maven-adattár webhelyén, vagy hozzáadhatja a tárat egy függőség hozzáadásával a buildfájlhoz:
SBT
libraryDependencies += "com.databricks" % "dbutils-api_TARGET" % "VERSION"Maven
<dependency> <groupId>com.databricks</groupId> <artifactId>dbutils-api_TARGET</artifactId> <version>VERSION</version> </dependency>Gradle
compile 'com.databricks:dbutils-api_TARGET:VERSION'
Cserélje le TARGET a kívánt célra (például 2.12) és VERSION a kívánt verzióra (például 0.0.5). Az elérhető célok és verziók listájáért tekintse meg a DBUtils API weboldalát a Maven-adattár webhelyén.
Miután ezt a könyvtárat felhasználva felépítette az alkalmazását, üzembe helyezheti az alkalmazást.
Fontos
A dbutils-api könyvtár csak helyileg teszi lehetővé egy alkalmazás lefordítását, amely dbutils-t használ, de a futtatását nem. Az alkalmazás futtatásához üzembe kell helyeznie az Azure Databricksben.
Korlátozások
A végrehajtókon belüli dbutils hívása váratlan eredményeket vagy hibákat eredményezhet.
Ha fájlrendszerműveleteket kell futtatnia a végrehajtókon keresztül dbutilshasználatával, tekintse meg a Fájlrendszerműveletek párhuzamosításacímű témakört.
A végrehajtókkal kapcsolatos információkért tekintse meg a fürtmód áttekintését az Apache Spark webhelyén.