tables parancscsoport

Note

Ezek az információk a Databricks CLI 0.205-ös és újabb verzióira vonatkoznak. A Databricks parancssori felülete nyilvános előzetes verzióban érhető el.

A Databricks CLI használatára a Databricks Licenc és a Databricks adatvédelmi nyilatkozata vonatkozik, beleértve a használati adatokra vonatkozó rendelkezéseket is.

A tablesDatabricks parancssori felületének parancscsoportja a Unity Catalogban lévő táblák kezelésére szolgáló parancsokat tartalmaz. Egy tábla a Unity Catalog háromszintű névterének harmadik rétegében található. Adatsorokat tartalmaz.

databricks-táblák létrehozása

Hozzon létre egy új táblát a megadott katalógusban és sémában.

Note

Ez az API csak külső Delta-táblák létrehozását támogatja. Csak TABLE_TYPE=EXTERNAL és DATA_SOURCE_FORMAT=DELTA támogatott. Az oszlopmaszkok nem támogatottak táblák ezen API-val történő létrehozásakor.

Külső Delta-tábla létrehozásához a hívónak rendelkeznie EXTERNAL_USE_SCHEMA kell a szülősémában és EXTERNAL_USE_LOCATION a külső helyen, a standard USE_CATALOG, CREATE_TABLEés USE_SCHEMACREATE_EXTERNAL_TABLE a jogosultságok mellett. A columns mezőnek Spark-kompatibilis formátumban kell lennie.

databricks tables create NAME CATALOG_NAME SCHEMA_NAME TABLE_TYPE DATA_SOURCE_FORMAT STORAGE_LOCATION [flags]

Arguments

NAME

    A tábla neve a szülőséma alapján.

CATALOG_NAME

    A szülőkatalógus neve.

SCHEMA_NAME

    A szülőséma neve a szülőkatalógushoz viszonyítva.

TABLE_TYPE

    A táblázat típusa. Támogatott értékek: EXTERNAL, EXTERNAL_SHALLOW_CLONE, FOREIGN, MANAGED, MANAGED_SHALLOW_CLONE, MATERIALIZED_VIEWMETRIC_VIEW, , STREAMING_TABLE. VIEW

DATA_SOURCE_FORMAT

    A tábla adatforrás-formátuma. Támogatott értékek: AVRO, CSV, DELTA, DELTASHARING, HIVE, ICEBERG, JSONORC, PARQUET, , TEXTés mások.

STORAGE_LOCATION

    A tábla tároló gyökér URL-címe (a táblákhoz és EXTERNAL a táblákhoz MANAGED szükséges).

Beállítások

--json JSON

    A beágyazott JSON-sztring vagy a @path JSON-fájl a kérelem törzsével.

Globális jelzők

Examples

Az alábbi példa egy külső Delta-táblát hoz létre:

databricks tables create my_table my_catalog my_schema EXTERNAL DELTA s3://my-bucket/my-table

Databricks-táblák törlése

Tábla törlése a megadott szülőkatalógusból és sémából. A hívónak a szülőkatalógus tulajdonosának kell lennie, rendelkeznie kell a USE_CATALOG szülőkatalógus jogosultságával, és a szülőséma tulajdonosának kell lennie, vagy a tábla tulajdonosának kell lennie, és rendelkeznie kell a USE_CATALOG szülőkatalógus jogosultságával és a USE_SCHEMA szülőséma jogosultságával.

databricks tables delete FULL_NAME [flags]

Arguments

FULL_NAME

    A tábla teljes neve.

Beállítások

Globális jelzők

Examples

A következő példa töröl egy táblát:

databricks tables delete my_catalog.my_schema.my_table

databricks-táblák vannak

Megtudhatja, hogy létezik-e tábla egy adott katalógushoz és sémához tartozó metaadattárban. A hívónak meg kell felelnie az alábbi követelmények egyikének:

• Legyen metaadattár-rendszergazda
• Legyen a szülőkatalógus tulajdonosa
• Legyen a törzsséma tulajdonosa, és rendelkezzen a törzskatalógus USE_CATALOG jogosultságával
• Rendelkeznie kell a USE_CATALOG szülőkatalógus jogosultságával és a USE_SCHEMA szülőséma jogosultságával, és vagy a tábla tulajdonosának kell lennie, vagy rendelkeznie kell a SELECT jogosultsággal a táblán.
• Rendelkezzen BROWSE jogosultsággal a szülőkatalógusban
• Rendelkezzen jogosultsággal BROWSE a szülősémára.

databricks tables exists FULL_NAME [flags]

Arguments

FULL_NAME

    A tábla teljes neve.

Beállítások

Globális jelzők

Examples

Az alábbi példa ellenőrzi, hogy létezik-e tábla:

databricks tables exists my_catalog.my_schema.my_table

databricks-táblák lekérése

Táblázat lekérése a metaadattárból egy adott katalógushoz és sémához. A hívónak meg kell felelnie az alábbi követelmények egyikének:

• Legyen metaadattár-rendszergazda
• Legyen a szülőkatalógus tulajdonosa
• Legyen a törzsséma tulajdonosa, és rendelkezzen a törzskatalógus USE_CATALOG jogosultságával
• Rendelkeznie kell a USE_CATALOG szülőkatalógus jogosultságával és a USE_SCHEMA szülőséma jogosultságával, és vagy a tábla tulajdonosának kell lennie, vagy rendelkeznie kell a SELECT jogosultsággal a táblán.

databricks tables get FULL_NAME [flags]

Arguments

FULL_NAME

    A tábla teljes neve.

Beállítások

--include-browse

    A válaszban szerepeljenek-e olyan táblák, amelyekhez az egyszerű felhasználó csak a szelektív metaadatokhoz fér hozzá.

--include-delta-metadata

    A válaszban szerepelnie kell-e a delta metaadatainak.

--include-manifest-capabilities

    Adja meg, hogy szerepel-e a táblázat képességeit tartalmazó jegyzék.

Globális jelzők

Examples

Az alábbi példa egy táblával kapcsolatos információkat kap:

databricks tables get my_catalog.my_schema.my_table

Az alábbi példa egy táblázatot kap, amely tartalmazza a delta metaadatait:

databricks tables get my_catalog.my_schema.my_table --include-delta-metadata

databricks-táblák listája

Az aktuális metaadattár összes táblájának felsorolása a szülőkatalógus és séma alatt. A hívónak metaadattárrendszergazdának vagy a tábla tulajdonosának kell lennie, vagy rendelkeznie kell a SELECT jogosultsággal a táblán. Az utóbbi esetben a hívónak tulajdonosnak kell lennie, vagy rendelkeznie kell a USE_CATALOG jogosultsággal a szülőkatalógusra és a USE_SCHEMA jogosultsággal a szülősémára. A tömb elemeinek adott sorrendje nem garantált.

databricks tables list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Az érdeklődésre számot tartó táblák szülőkatalógusának neve.

SCHEMA_NAME

    Táblák szülősémája.

Beállítások

--include-browse

    A válaszban szerepeljenek-e olyan táblák, amelyekhez az egyszerű felhasználó csak a szelektív metaadatokhoz fér hozzá.

--include-delta-metadata

    A válaszban szerepelnie kell-e a delta metaadatainak.

--include-manifest-capabilities

    Adja meg, hogy szerepel-e a táblázat képességeit tartalmazó jegyzék.

--max-results int

    A visszaadandó táblák maximális száma.

--omit-columns

    Kihagyja-e a tábla oszlopait a válaszból, vagy sem.

--omit-properties

    Azt határozza meg, hogy kihagyja-e a tábla tulajdonságait a válaszból.

--omit-username

    Kihagyja-e a tábla felhasználónevét (pl.

--page-token string

    Átlátszatlan jogkivonat, amely a következő oldalra küldendő.

Globális jelzők

Examples

Az alábbi példa egy katalógus és séma összes tábláját felsorolja:

databricks tables list my_catalog my_schema

Az alábbi példa a kihagyott oszlopokat tartalmazó táblákat sorolja fel:

databricks tables list my_catalog my_schema --omit-columns

databricks táblák összefoglaló listája

A metaadattárban lévő sémák és katalógusok tábláinak összefoglalóinak listázása. A visszaadott táblázat összefoglalók a következők lehetnek:

• táblázatok összegzése (az aktuális metaadattárban és szülőkatalógusban és sémában), ha a felhasználó metaadattár-rendszergazda,
• vagy összefoglalók olyan táblákhoz és sémákhoz (az aktuális metaadattárban és a szülőkatalógusban), amelyekhez a felhasználó rendelkezik tulajdonosi joggal vagy SELECT jogosultsággal a táblában, valamint tulajdonjoggal vagy USE_SCHEMA jogosultsággal a sémában, feltéve, hogy a felhasználó a szülőkatalógusban is rendelkezik tulajdonjoggal vagy USE_CATALOG jogosultsággal.

A tömb elemeinek adott sorrendje nem garantált.

databricks tables list-summaries CATALOG_NAME [flags]

Arguments

CATALOG_NAME

    Az érdeklődésre számot tartó táblák szülőkatalógusának neve.

Beállítások

--include-manifest-capabilities

    Adja meg, hogy szerepel-e a táblázat képességeit tartalmazó jegyzék.

--max-results int

    A visszaadandó táblák összegzéseinek maximális száma.

--page-token string

    Átlátszatlan lapozási token a következő oldalra ugráshoz az előző lekérdezés alapján.

--schema-name-pattern string

    Sql LIKE-minta (% és _) sémanevekhez.

--table-name-pattern string

    Sql LIKE-minta (% és _) táblanevekhez.

Globális jelzők

Examples

Az alábbi példa egy katalógus táblázatösszegzőit sorolja fel:

databricks tables list-summaries my_catalog

Az alábbi példa a sémanévmintával rendelkező táblázatösszegzőket sorolja fel:

databricks tables list-summaries my_catalog --schema-name-pattern "prod_%"

Az alábbi példa táblázatnévmintával rendelkező táblázatösszegzőket sorol fel:

databricks tables list-summaries my_catalog --table-name-pattern "fact_%"

Globális jelzők

--debug

  Engedélyezze-e a hibakeresési naplózást.

-h vagy --help

    Súgó megjelenítése a Databricks parancssori felületéhez, a kapcsolódó parancscsoporthoz vagy a kapcsolódó parancshoz.

--log-file karakterlánc

    A karakterlánc, amely megadja, melyik fájlba írja az kimeneti naplókat. Ha ez a jelző nincs megadva, akkor az alapértelmezett beállítás a kimeneti naplók stderrbe írása.

--log-format formátum

    A naplóformátum típusa, amely lehet text vagy json. Az alapértelmezett érték a text.

--log-level karakterlánc

    A naplóformátum szintjét képviselő karakterlánc. Ha nincs megadva, a naplóformátum szintje le van tiltva.

-o, --output típus

    A parancs kimenettípusa: text vagy json. Az alapértelmezett érték a text.

-p, --profile karakterlánc

    A parancs futtatásához használni kívánt fájl profiljának ~/.databrickscfg neve. Ha ez a jelző nincs megadva, akkor ha létezik, a rendszer a névvel ellátott DEFAULT profilt használja.

--progress-format formátum

    A folyamatnaplók megjelenítésének formátuma: default, append, inplacevagy json

-t, --target karakterlánc

    Ha alkalmazható, a használni kívánt célcsomag