apps 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 appsDatabricks parancssori felületének parancscsoportja lehetővé teszi az alkalmazások kezelését. Az alkalmazások közvetlenül az ügyfél Databricks-példányán futnak, integrálhatók az adataikkal, használják és bővítik a Databricks-szolgáltatásokat, és lehetővé teszik a felhasználók számára az egyszeri bejelentkezésen keresztüli interakciót. Lásd : Databricks Apps.

databricks applikációk létrehozása

Új alkalmazás létrehozása.

databricks apps create NAME [flags]

Arguments

NAME

    Az alkalmazás neve. A név csak kisbetűs alfanumerikus karaktereket és kötőjeleket tartalmazhat. A munkaterületen belül egyedinek kell lennie.

Beállítások

--budget-policy-id string

    Az alkalmazás költségvetési szabályzatának azonosítója.

--compute-size ComputeSize

    Az alkalmazás számítási mérete. Támogatott értékek: LARGE, MEDIUM.

--description string

    Az alkalmazás leírása.

--json JSON

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

--no-compute

    Ha igaz, az alkalmazás nem indul el a létrehozás után.

--no-wait

    Ne várja meg, hogy elérje az AKTÍV állapotot.

--space string

    Annak a területnek a neve, amelyhez az alkalmazás tartozik.

--timeout duration

    Az ACTIVE állapot elérésének maximális időtartama (alapértelmezett 20m0s).

--usage-policy-id string

    Az alkalmazás használati szabályzatának azonosítója.

Globális jelzők

Examples

Az alábbi példa egy alapszintű alkalmazást hoz létre:

databricks apps create my-analytics-app --description "Analytics dashboard app"

Az alábbi példa egy alkalmazást hoz létre anélkül, hogy elindítanák:

databricks apps create my-data-app --description "Data processing app" --no-compute

Az alábbi példa egy testreszabott időtúllépéssel rendelkező alkalmazást hoz létre:

databricks apps create my-ml-app --description "Machine learning app" --timeout 30m

databricks-alkalmazások létrehozási frissítése

Létrehoz egy alkalmazásfrissítést, és elindítja a frissítési folyamatot. A frissítési folyamat aszinkron, és a frissítés állapota a GetAppUpdate metódussal ellenőrizhető.

databricks apps create-update APP_NAME UPDATE_MASK [flags]

Arguments

APP_NAME

    Az alkalmazás neve.

UPDATE_MASK

    A mezőmaszknak egyetlen sztringnek kell lennie, több mezőt vesszővel elválasztva (szóköz nélkül). A mező elérési útja az erőforrás-objektumhoz viszonyítva, pont (.) használatával navigál az almezőkben (például author.given_name). A szekvencia- vagy térképmezők elemeinek megadása nem engedélyezett, mivel csak a teljes gyűjteménymező adható meg. A mezőneveknek pontosan meg kell egyeznie az erőforrásmezők nevével.

    A * mezőmaszk a teljes cserét jelzi. Javasoljuk, hogy mindig explicit módon listázze a frissítendő mezőket, és kerülje a * helyettesítő karakterek használatát, mivel ez nem várt eredményekhez vezethet, ha az API a jövőben megváltozik.

Beállítások

--json JSON

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

--no-wait

    Ne várja meg, hogy elérje a SIKERES állapotot.

--timeout duration

    A SIKERES állapot elérésének maximális időtartama (alapértelmezett 20m0s).

Globális jelzők

Examples

Az alábbi példa egy alkalmazásfrissítést hoz létre egy adott mezőmaszkkal:

databricks apps create-update my-analytics-app "description" --json '{"description": "Updated app description"}'

Az alábbi példa egy alkalmazásfrissítést hoz létre a befejezésre való várakozás nélkül:

databricks apps create-update my-data-app "budget_policy_id" --json '{"budget_policy_id": "new-policy-123"}' --no-wait

Az alábbi példa egy alkalmazásfrissítést hoz létre egyéni időtúllépéssel:

databricks apps create-update my-ml-app "description,budget_policy_id" --json '{"description": "Updated ML app", "budget_policy_id": "ml-policy-456"}' --timeout 30m

databricks alkalmazások törlése

Alkalmazás törlése.

Ha argumentum nélkül NAME futtat egy Databricks Apps-projektkönyvtárból (amely tartalmazza a databricks.yml) parancsot, ez a parancs megsemmisíti a projekt által üzembe helyezett összes erőforrást. Ha argumentumot NAME ad meg, vagy ha nem egy projektkönyvtárban, közvetlenül az API használatával törli a megadott alkalmazást.

databricks apps delete [NAME] [flags]

Arguments

NAME

    Az alkalmazás neve. Akkor szükséges, ha nincs projektkönyvtárban. Ha egy projektkönyvtárban meg van adva, a projektromboló helyett API-törlést használ.

Beállítások

--auto-approve

    Az erőforrások és fájlok törléséhez hagyja ki az interaktív jóváhagyásokat.

--force-lock

    Az üzembehelyezési zár kényszerítése.

Globális jelzők

Examples

Az alábbi példa töröl egy alkalmazást:

databricks apps delete my-analytics-app

Az alábbi példa egy projektkönyvtár összes projekterőforrását megsemmisíti:

databricks apps delete

Az alábbi példa automatikus jóváhagyással megsemmisíti a projekterőforrásokat:

databricks apps delete --auto-approve

Databricks-alkalmazások üzembe helyezése

Alkalmazástelepítés létrehozása.

Ha argumentum nélkül APP_NAME futtat egy Databricks Apps-projektkönyvtárból (amely databricks.ymltartalmaz) egy továbbfejlesztett üzembe helyezési folyamatot, amely ellenőrzi a projektet, üzembe helyezi a munkaterületen, és futtatja az alkalmazást. Ha argumentumot APP_NAME ad meg, vagy ha nem egy projektkönyvtárban, közvetlenül az API használatával hoz létre alkalmazástelepítést.

databricks apps deploy [APP_NAME] [flags]

Arguments

APP_NAME

    Az alkalmazás neve. Akkor szükséges, ha nincs projektkönyvtárban. Ha egy projektkönyvtárban meg van adva, a projekt üzembe helyezése helyett AZ API-t használja.

Beállítások

--deployment-id string

    Az üzembe helyezés egyedi azonosítója.

--force

    A Git-ág kényszerítő felülbírálása.

--json JSON

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

--mode AppDeploymentMode

    Az a mód, amelynek az üzembe helyezése kezeli a forráskódot. Támogatott értékek: AUTO_SYNC, SNAPSHOT.

--no-wait

    Ne várja meg, hogy elérje a SIKERES állapotot.

--skip-tests

    Hagyja ki a tesztek futtatását az ellenőrzés során (alapértelmezett igaz).

--skip-validation

    Hagyja ki a projektérvényesítést (build, typecheck, lint).

--source-code-path string

    Az alkalmazástelepítés létrehozásához használt forráskód munkaterületi fájlrendszer-elérési útja.

--timeout duration

    A SIKERES állapot elérésének maximális időtartama (alapértelmezett 20m0s).

Globális jelzők

Examples

Az alábbi példa automatikus szinkronizálási móddal hoz létre üzembe helyezést:

databricks apps deploy my-analytics-app --source-code-path /Workspace/Users/someone@example.com/my-app --mode AUTO_SYNC

Az alábbi példa pillanatkép módú üzembe helyezést hoz létre:

databricks apps deploy my-data-app --source-code-path /Workspace/Users/someone@example.com/data-app --mode SNAPSHOT

Az alábbi példa egy egyéni üzembehelyezési azonosítóval rendelkező üzembe helyezést hoz létre:

databricks apps deploy my-ml-app --deployment-id "v1.2.3" --source-code-path /Workspace/Users/someone@example.com/ml-app

Databricks-alkalmazások lekérése

Az alkalmazás adatainak lekérése a megadott névvel.

databricks apps get NAME [flags]

Arguments

NAME

    Az alkalmazás neve.

Beállítások

Globális jelzők

Examples

Az alábbi példa alkalmazásinformációkat kap:

databricks apps get my-analytics-app

Az alábbi példa JSON formátumban kapja meg az alkalmazásadatokat:

databricks apps get my-data-app --output json

Az alábbi példa alkalmazásadatokat kap egy adott profil használatával:

databricks apps get my-ml-app --profile production

databricks-alkalmazások üzembe helyezése

Az alkalmazás telepítésével kapcsolatos információk lekérése a megadott névvel és üzembe helyezési azonosítóval.

databricks apps get-deployment APP_NAME DEPLOYMENT_ID [flags]

Arguments

APP_NAME

    Az alkalmazás neve.

DEPLOYMENT_ID

    Az üzembe helyezés egyedi azonosítója.

Beállítások

Globális jelzők

Examples

Az alábbi példa beolvasja az üzembehelyezési információkat:

databricks apps get-deployment my-analytics-app v1.0.0

Az alábbi példa az üzembehelyezési információkat JSON formátumban kapja meg:

databricks apps get-deployment my-data-app v2.1.0 --output json

Az alábbi példa egy adott profillal kapja meg az üzembehelyezési információkat:

databricks apps get-deployment my-ml-app latest --profile production

databricks-alkalmazások get-update

Alkalmazásfrissítés állapotának lekérése.

databricks apps get-update APP_NAME [flags]

Arguments

APP_NAME

    Az alkalmazás neve.

Beállítások

Globális jelzők

Examples

Az alábbi példa egy alkalmazásfrissítés állapotát kapja meg:

databricks apps get-update my-analytics-app

Az alábbi példa JSON formátumban kapja meg a frissítési állapotot:

databricks apps get-update my-data-app --output json

Az alábbi példa egy adott profil frissítési állapotát kapja meg:

databricks apps get-update my-ml-app --profile production

databricks-alkalmazások importálása

(Kísérleti) Importáljon egy meglévő Databricks-alkalmazást csomagként.

Importáljon egy meglévő Databricks-alkalmazást, és konvertálja csomagkonfigurációvá. Ez a parancs létrehoz egy új csomagkönyvtárat az alkalmazáskonfigurációval, letölti az alkalmazás forráskódját, a csomagot a meglévő alkalmazáshoz köti, és közvetlen üzembe helyezési móddal telepíti.

databricks apps import [flags]

Arguments

None

Beállítások

--cleanup

    Törölje az előző alkalmazásmappát és annak tartalmát.

--force-import

    A már importált alkalmazás újbóli importálásának kényszerítése (csak a saját alkalmazásainál működik).

--name string

    Az importálandó alkalmazás neve. Ha nincs megadva, az interaktív kijelöléshez szükséges összes alkalmazás listája.

--output-dir string

    Könyvtár a csomag kimenetéhez. Az alkalmazásnév alapértelmezett értéke.

-q, --quiet

    Tiltsa le az információs üzeneteket (csak hibaüzeneteket és utasításokat jelenítsen meg).

Globális jelzők

Examples

Az alábbi példa importál egy alkalmazást, és létrehoz egy, az alkalmazásról elnevezett könyvtárat:

databricks apps import --name my-streamlit-app

Az alábbi példa egy egyéni kimeneti könyvtárral rendelkező alkalmazást importál:

databricks apps import --name my-app --output-dir ~/my-apps/analytics

Az alábbi példa importál egy alkalmazást, és törli a régi alkalmazásmappát:

databricks apps import --name my-app --cleanup

databricks-alkalmazások listája

A munkaterület összes alkalmazásának listázása.

databricks apps list [flags]

Arguments

None

Beállítások

--page-size int

    A visszaadott elemek felső határa.

--page-token string

    Lapozási jogkivonat az alkalmazások következő oldalára való ugráshoz.

--space string

    Alkalmazások szűrése alkalmazástérnév alapján.

Globális jelzők

Examples

Az alábbi példa az összes alkalmazást felsorolja:

databricks apps list

Az alábbi példa egy adott oldalméretű alkalmazásokat sorol fel:

databricks apps list --page-size 10

Az alábbi példa a lapszámozással rendelkező alkalmazásokat sorolja fel:

databricks apps list --page-token "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

databricks apps list-deployments

Jelenítsd meg vagy listázd az összes alkalmazástelepítést a megadott nevű alkalmazáshoz.

databricks apps list-deployments APP_NAME [flags]

Arguments

APP_NAME

    Az alkalmazás neve.

Beállítások

--page-size int

    A visszaadott elemek felső határa.

--page-token string

    Lapozási jogkivonat az alkalmazások következő oldalára való ugráshoz.

Globális jelzők

Examples

Az alábbi példa egy alkalmazás összes üzembe helyezését felsorolja:

databricks apps list-deployments my-analytics-app

Az alábbi példa egy adott oldalméretű üzembe helyezéseket sorol fel:

databricks apps list-deployments my-data-app --page-size 10

databricks-alkalmazások naplói

Stdout/stderr naplók streamelése a Databricks alkalmazás saját naplóstreamjének használatával. Alapértelmezés szerint ez a parancs lekéri a legutóbbi naplókat --tail-lines és kilép. A kiszolgálóoldali szűrés a használatával --search érhető el, az ügyféloldali szűrés pedig a használatával --source APP|SYSTEMérhető el.

databricks apps logs [NAME] [flags]

Arguments

NAME

    Az alkalmazás neve.

Beállítások

-f, --follow

    Folytassa a naplók streamelését, amíg le nem állítják vagy elér egy megadott időtúllépést.

--tail-lines int

    A legutóbbi naplósorok száma a streamelés előtt. Úgy van beállítva, 0 hogy mindent megjelenítsen. Alapértelmezett: 200

--timeout duration

    A streamelés maximális ideje, ha --follow be van állítva. Állítsa 0 értékre az időkorlát letiltásához.

--search string

    Küldje el a keresési kifejezést a naplószolgáltatásnak a streamelés előtt.

--source strings

    Korlátozza a naplókat APP vagy SYSTEM forrásokra.

--output-file string

    Az stdout mellett nem kötelezően megadható naplófájl elérési útja.

Globális jelzők

Examples

Az alábbi példa beolvassa egy alkalmazás legutóbbi naplóit:

databricks apps logs my-analytics-app

Az alábbi példa folyamatosan streameli a naplókat, amíg megszakad:

databricks apps logs my-analytics-app --follow

Az alábbi példa lekéri az utolsó 500 naplósorait:

databricks apps logs my-data-app --tail-lines 500

Az alábbi példa 10 perces időtúllépéssel streameli a naplókat:

databricks apps logs my-ml-app --follow --timeout 10m

Az alábbi példa egy keresési kifejezés alapján szűri a naplókat:

databricks apps logs my-analytics-app --search "error"

Az alábbi példa csak alkalmazásszintű kimenetre korlátozza a naplókat:

databricks apps logs my-data-app --source APP

Az alábbi példa naplókat ír mind az stdout, mind a fájl számára:

databricks apps logs my-ml-app --output-file /tmp/app-logs.txt

databricks-alkalmazások helyi futtatása

Helyileg indíthat el egy alkalmazást.

databricks apps run-local [flags]

Arguments

None

Beállítások

--app-port int

    Az alkalmazás futtatásához használt port (alapértelmezett 8000).

--debug

    Hibakeresési mód engedélyezése.

--debug-port string

    Port, amelyen futtatni szeretné a hibakeresőt.

--entry-point string

    Adja meg az alkalmazás konfigurációjával (.yml fájllal) rendelkező egyéni belépési pontot. Alapértelmezett érték: app.yml.

--env strings

    Környezeti változók beállítása.

--port int

    Az alkalmazásproxy futtatásához használt port (alapértelmezett 8001).

--prepare-environment

    Előkészíti a környezetet az alkalmazás futtatására. Szükséges az UV telepítése.

Globális jelzők

Examples

Az alábbi példa helyileg futtat egy alkalmazást az alapértelmezett beállításokkal:

databricks apps run-local

Az alábbi példa helyileg futtat egy alkalmazást egy adott porton:

databricks apps run-local --app-port 9000 --port 9001

Databricks alkalmazások elindítása

Indítsa el az alkalmazás utolsó aktív üzembe helyezését a munkaterületen.

databricks apps start [NAME] [flags]

Arguments

NAME

    Az alkalmazás neve.

Beállítások

--no-wait

    Ne várja meg, hogy elérje az AKTÍV állapotot.

--timeout duration

    Az ACTIVE állapot elérésének maximális időtartama (alapértelmezett 20m0s).

Globális jelzők

Examples

Az alábbi példa elindít egy alkalmazást:

databricks apps start my-analytics-app

Az alábbi példa várakozás nélkül indít el egy alkalmazást:

databricks apps start my-data-app --no-wait

Az alábbi példa egyéni időkorláttal indít el egy alkalmazást.

databricks apps start my-ml-app --timeout 30m

A databricks-alkalmazások leállnak

Állítsa le az alkalmazás aktív üzembe helyezését a munkaterületen.

databricks apps stop [NAME] [flags]

Arguments

NAME

    Az alkalmazás neve.

Beállítások

--no-wait

    Ne várja meg, hogy elérje a LEÁLLÍTVA állapotot.

--timeout duration

    A STOPPED állapot elérésének maximális időtartama (alapértelmezett 20m0s).

Globális jelzők

Examples

Az alábbi példa leállítja az alkalmazást:

databricks apps stop my-analytics-app

Az alábbi példa várakozás nélkül leállítja az alkalmazást:

databricks apps stop my-data-app --no-wait

Az alábbi példa leállítja az egyéni időtúllépéssel rendelkező alkalmazásokat:

databricks apps stop my-ml-app --timeout 30m

databricks-alkalmazások frissítése

Frissítse az alkalmazást a megadott névvel.

databricks apps update NAME [flags]

Arguments

NAME

    Az alkalmazás neve. A név csak kisbetűs alfanumerikus karaktereket és kötőjeleket tartalmazhat. A munkaterületen belül egyedinek kell lennie.

Beállítások

--budget-policy-id string

    Az alkalmazás költségvetési szabályzatának azonosítója.

--compute-size ComputeSize

    Az alkalmazás számítási mérete. Támogatott értékek: LARGE, MEDIUM.

--description string

    Az alkalmazás leírása.

--json JSON

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

--space string

    Annak a területnek a neve, amelyhez az alkalmazás tartozik.

--usage-policy-id string

    Az alkalmazás használati szabályzatának azonosítója.

Globális jelzők

Examples

Az alábbi példa frissíti az alkalmazás leírását:

databricks apps update my-analytics-app --description "Updated analytics dashboard"

databricks-alkalmazások jogosultsági-szintek-lekérése

Alkalmazásengedély-szintek lekérése.

databricks apps get-permission-levels APP_NAME [flags]

Arguments

APP_NAME

    Az az alkalmazás, amelyhez engedélyeket kell beszerezni vagy kezelni.

Beállítások

Globális jelzők

Examples

Az alábbi példa egy alkalmazás engedélyszintjeit kapja meg:

databricks apps get-permission-levels my-analytics-app

databricks-alkalmazások hozzáférési-jogosultságok-lekérése

Egy alkalmazás engedélyeinek lekérése. Az alkalmazások a gyökérobjektumuktól örökölhetnek engedélyeket.

databricks apps get-permissions APP_NAME [flags]

Arguments

APP_NAME

    Az az alkalmazás, amelyhez engedélyeket kell beszerezni vagy kezelni.

Beállítások

Globális jelzők

Examples

Az alábbi példa egy alkalmazás engedélyeit kapja meg:

databricks apps get-permissions my-analytics-app

Az alábbi példa egy adott profillal kapja meg az engedélyeket:

databricks apps get-permissions my-ml-app --profile production

databricks-alkalmazások beállítási engedélyei

Alkalmazásengedélyek beállítása.

Beállítja az engedélyeket egy objektumon, és lecseréli a meglévő engedélyeket, ha léteznek. Törli az összes közvetlen engedélyt, ha nincs megadva. Az objektumok a gyökérobjektumtól örökölhetnek engedélyeket.

databricks apps set-permissions APP_NAME [flags]

Arguments

APP_NAME

    Az az alkalmazás, amelyhez engedélyeket kell beszerezni vagy kezelni.

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 JSON-konfigurációval állítja be az engedélyeket:

databricks apps set-permissions my-analytics-app --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_USE"}]}'

databricks-alkalmazások frissítési engedélyei

Frissítse egy alkalmazás engedélyeit. Az alkalmazások a gyökérobjektumuktól örökölhetnek engedélyeket.

databricks apps update-permissions APP_NAME [flags]

Arguments

APP_NAME

    Az az alkalmazás, amelyhez engedélyeket kell beszerezni vagy kezelni.

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 JSON-konfigurációval frissíti az engedélyeket:

databricks apps update-permissions my-analytics-app --json '{"access_control_list": [{"user_name": "someone@example.com", "permission_level": "CAN_MANAGE"}]}'

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 húr

    A kimeneti naplók írásához a fájlt jelképező sztring. 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 vagy textjson. Az alapértelmezett érték a text.

--log-level húr

    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 vagy textjson. Az alapértelmezett érték a text.

-p, --profile húr

    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 húr

    Adott esetben a használni kívánt csomagcél