Udostępnij przez


apps grupa poleceń

Note

Te informacje dotyczą interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej. Interfejs CLI Databricks jest w publicznej wersji testowej.

Korzystanie z interfejsu wiersza polecenia usługi Databricks podlega licencjom usługi Databricks i powiadomieniom o ochronie prywatności usługi Databricks, w tym wszelkim przepisom dotyczącym danych użycia.

Grupa apps poleceń w interfejsie wiersza polecenia usługi Databricks umożliwia zarządzanie aplikacjami. Aplikacje działają bezpośrednio w wystąpieniu usługi Databricks klienta, integrują się z danymi, używają i rozszerzają usługi Databricks oraz umożliwiają użytkownikom interakcję za pomocą logowania jednokrotnego. Zobacz Aplikacje usługi Databricks.

tworzenie aplikacji databricks

Tworzenie nowej aplikacji.

databricks apps create NAME [flags]

Arguments

NAME

    Nazwa aplikacji. Nazwa musi zawierać tylko małe litery alfanumeryczne i łączniki. Musi być unikatowa w obszarze roboczym.

Opcje

--budget-policy-id string

    Identyfikator zasad budżetu dla aplikacji.

--description string

    Opis aplikacji.

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--no-compute

    Jeśli to prawda, aplikacja nie zostanie uruchomiona po utworzeniu.

--no-wait

    Nie czekaj, aż osiągnie stan AKTYWNY.

--timeout duration

    Maksymalny czas osiągnięcia stanu AKTYWNE (domyślnie 20 ms).

Flagi globalne

Examples

Poniższy przykład tworzy podstawową aplikację:

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

Poniższy przykład tworzy aplikację bez jej uruchamiania:

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

Poniższy przykład tworzy aplikację z niestandardowym limitem czasu:

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

databricks usuń aplikacje

Usuwanie aplikacji.

databricks apps delete NAME [flags]

Arguments

NAME

    Nazwa aplikacji.

Opcje

Flagi globalne

Examples

Poniższy przykład usuwa aplikację:

databricks apps delete my-analytics-app

wdrażanie aplikacji na platformie Databricks

Utwórz wdrożenie aplikacji dla aplikacji o podanej nazwie.

databricks apps deploy APP_NAME [flags]

Arguments

APP_NAME

    Nazwa aplikacji.

Opcje

--deployment-id string

    Unikatowy identyfikator wdrożenia.

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

--mode AppDeploymentMode

    Tryb, w którym wdrożenie będzie zarządzać kodem źródłowym. Obsługiwane wartości: AUTO_SYNC, SNAPSHOT.

--no-wait

    Nie czekaj na osiągnięcie stanu POWODZENIE.

--source-code-path string

    Ścieżka systemu plików kodu źródłowego w obszarze roboczym użytego do utworzenia wdrożenia aplikacji.

--timeout duration

    Maksymalny czas na osiągnięcie stanu ZAKOŃCZONO (domyślnie 20 min 0 s).

Flagi globalne

Examples

Poniższy przykład tworzy wdrożenie z trybem automatycznej synchronizacji:

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

Poniższy przykład tworzy wdrożenie z trybem migawki:

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

Poniższy przykład tworzy wdrożenie z niestandardowym identyfikatorem wdrożenia:

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

pobierz aplikacje databricks

Uzyskaj informacje dotyczące aplikacji o podanej nazwie.

databricks apps get NAME [flags]

Arguments

NAME

    Nazwa aplikacji.

Opcje

Flagi globalne

Examples

Poniższy przykład pobiera informacje o aplikacji:

databricks apps get my-analytics-app

Poniższy przykład pobiera informacje o aplikacji w formacie JSON:

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

Poniższy przykład pobiera informacje o aplikacji przy użyciu określonego profilu:

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

aplikacje databricks get-deployment

Uzyskaj informacje dotyczące wdrożenia aplikacji z podaną nazwą i identyfikatorem wdrożenia.

databricks apps get-deployment APP_NAME DEPLOYMENT_ID [flags]

Arguments

APP_NAME

    Nazwa aplikacji.

DEPLOYMENT_ID

    Unikatowy identyfikator wdrożenia.

Opcje

Flagi globalne

Examples

Poniższy przykład pobiera informacje o wdrożeniu:

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

Poniższy przykład pobiera informacje o wdrożeniu w formacie JSON:

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

Przykład, który znajduje się poniżej, pobiera informacje o wdrożeniu za pomocą określonego profilu:

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

lista aplikacji databricks

Wyświetl listę wszystkich aplikacji w obszarze roboczym.

databricks apps list [flags]

Arguments

None

Opcje

--page-size int

    Górna granica dla zwracanych elementów.

--page-token string

    Token stronicowania, aby przejść na następną stronę aplikacji.

Flagi globalne

Examples

Poniższy przykład zawiera listę wszystkich aplikacji:

databricks apps list

W poniższym przykładzie wymieniono aplikacje o określonym rozmiarze strony:

databricks apps list --page-size 10

W poniższym przykładzie wymieniono aplikacje z paginacją.

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

lista wdrożeń aplikacji Databricks

Wyświetl listę wszystkich wdrożeń aplikacji dla aplikacji o podanej nazwie.

databricks apps list-deployments APP_NAME [flags]

Arguments

APP_NAME

    Nazwa aplikacji.

Opcje

--page-size int

    Górna granica dla zwracanych elementów.

--page-token string

    Token stronicowania, aby przejść na następną stronę aplikacji.

Flagi globalne

Examples

Poniższy przykład zawiera listę wszystkich wdrożeń aplikacji:

databricks apps list-deployments my-analytics-app

W poniższym przykładzie wymieniono wdrożenia o określonym rozmiarze strony:

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

Logi aplikacji Databricks

Przesyłanie strumieniowe dzienników stdout/stderr dla aplikacji usługi Databricks przy użyciu strumienia dziennika. Domyślnie to polecenie pobiera najnowsze dzienniki do --tail-lines i kończy działanie. Filtrowanie po stronie serwera jest dostępne za pomocą funkcji --search , a filtrowanie po stronie klienta jest dostępne przy użyciu programu --source APP|SYSTEM.

databricks apps logs NAME [flags]

Arguments

NAME

    Nazwa aplikacji.

Opcje

-f, --follow

    Kontynuuj przesyłanie strumieniowe dzienników do momentu anulowania lub osiągnięcia określonego limitu czasu.

--tail-lines int

    Liczba ostatnich wierszy dziennika do wyświetlenia przed rozpoczęciem przesyłania strumieniowego. Ustaw na 0, aby pokazać wszystko. Ustawienie domyślne: 200

--timeout duration

    Maksymalny czas przesyłania strumieniowego, gdy --follow jest ustawione. Ustaw 0, aby wyłączyć limit czasu.

--search string

    Wyślij termin wyszukiwania do usługi rejestrowania przed transmisją strumieniową.

--source strings

    Ogranicz dzienniki do źródła APP lub SYSTEM.

--output-file string

    Opcjonalna ścieżka pliku do zapisywania dzienników obok stdout.

Flagi globalne

Examples

Poniższy przykład pobiera najnowsze dzienniki dla aplikacji:

databricks apps logs my-analytics-app

Poniższy przykład przesyła strumieniowo logi w sposób ciągły, aż do momentu przerwania.

databricks apps logs my-analytics-app --follow

Poniższy przykład pobiera ostatnie 500 wierszy dzienników:

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

Poniższy przykład przesyła strumieniowo dzienniki z limitem czasu 10 minut:

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

Poniższy przykład filtruje dzienniki według terminu wyszukiwania:

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

Poniższy przykład ogranicza dzienniki tylko do danych wyjściowych na poziomie aplikacji:

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

W poniższym przykładzie dzienniki są zapisywane zarówno w pliku stdout, jak i w pliku:

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

Aplikacje Databricks uruchomić lokalnie

Uruchom aplikację lokalnie.

databricks apps run-local [flags]

Arguments

None

Opcje

--app-port int

    Port, na którym ma zostać uruchomiona aplikacja (domyślnie 8000).

--debug

    Włącz tryb debugowania.

--debug-port string

    Port, na którym ma zostać uruchomiony debuger.

--entry-point string

    Określ niestandardowy punkt wejścia z konfiguracją (plik .yml) dla aplikacji. Wartość domyślna to app.yml.

--env strings

    Ustaw zmienne środowiskowe.

--port int

    Port, na którym ma zostać uruchomiony serwer proxy aplikacji (domyślnie 8001).

--prepare-environment

    Przygotowuje środowisko do uruchamiania aplikacji. Wymaga zainstalowania uv.

Flagi globalne

Examples

Poniższy przykład uruchamia aplikację lokalnie z ustawieniami domyślnymi:

databricks apps run-local

Poniższy przykład uruchamia aplikację lokalnie na określonym porcie:

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

Uruchomienie aplikacji Databricks

Uruchom ostatnie aktywne wdrożenie aplikacji w obszarze roboczym.

databricks apps start NAME [flags]

Arguments

NAME

    Nazwa aplikacji.

Opcje

--no-wait

    Nie czekaj, aż osiągnie stan AKTYWNY.

--timeout duration

    Maksymalny czas osiągnięcia stanu AKTYWNE (domyślnie 20 ms).

Flagi globalne

Examples

Poniższy przykład uruchamia aplikację:

databricks apps start my-analytics-app

Poniższy przykład uruchamia aplikację bez oczekiwania:

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

Poniższy przykład uruchamia aplikację z niestandardowym limitem czasu:

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

zatrzymuj aplikacje Databricks

Zatrzymaj aktywne wdrażanie aplikacji w obszarze roboczym.

databricks apps stop NAME [flags]

Arguments

NAME

    Nazwa aplikacji.

Opcje

--no-wait

    Nie czekaj, aż osiągnie stan zatrzymania.

--timeout duration

    Maksymalny czas osiągnięcia stanu ZATRZYMANO (domyślnie 20 ms).

Flagi globalne

Examples

Poniższy przykład zatrzymuje aplikację:

databricks apps stop my-analytics-app

Poniższy przykład zatrzymuje aplikację bez oczekiwania:

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

Poniższy przykład zatrzymuje aplikację z niestandardowym limitem czasu:

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

aktualizacja aplikacji usługi databricks

Zaktualizuj aplikację przy użyciu podanej nazwy.

databricks apps update NAME [flags]

Arguments

NAME

    Nazwa aplikacji. Nazwa musi zawierać tylko małe litery alfanumeryczne i łączniki. Musi być unikatowa w obszarze roboczym.

Opcje

--budget-policy-id string

    Identyfikator zasad budżetu dla aplikacji.

--description string

    Opis aplikacji.

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

Flagi globalne

Examples

Poniższy przykład aktualizuje opis aplikacji:

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

Pobierz poziomy uprawnień aplikacji databricks

Uzyskiwanie poziomów uprawnień aplikacji.

databricks apps get-permission-levels APP_NAME [flags]

Arguments

APP_NAME

    Aplikacja, dla której chcesz uzyskać uprawnienia lub zarządzać nimi.

Opcje

Flagi globalne

Examples

Poniższy przykład pobiera poziomy uprawnień dla aplikacji:

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

Pobieranie uprawnień przez aplikacje usługi databricks

Uzyskaj uprawnienia aplikacji. Aplikacje mogą dziedziczyć uprawnienia po ich obiekcie głównym.

databricks apps get-permissions APP_NAME [flags]

Arguments

APP_NAME

    Aplikacja, dla której chcesz uzyskać uprawnienia lub zarządzać nimi.

Opcje

Flagi globalne

Examples

Poniższy przykład pobiera uprawnienia dla aplikacji:

databricks apps get-permissions my-analytics-app

Poniższy przykład pobiera uprawnienia przy użyciu określonego profilu:

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

Ustawianie uprawnień aplikacji Databricks

Ustaw uprawnienia aplikacji.

Ustawia uprawnienia do obiektu, zastępując istniejące uprawnienia, jeśli istnieją. Usuwa wszystkie uprawnienia bezpośrednie, jeśli nie określono żadnego. Obiekty mogą dziedziczyć uprawnienia po ich obiekcie głównym.

databricks apps set-permissions APP_NAME [flags]

Arguments

APP_NAME

    Aplikacja, dla której chcesz uzyskać uprawnienia lub zarządzać nimi.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

Flagi globalne

Examples

Poniższy przykład ustawia uprawnienia przy użyciu konfiguracji JSON:

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

aktualizacja uprawnień aplikacji Databricks

Zaktualizuj uprawnienia w aplikacji. Aplikacje mogą dziedziczyć uprawnienia po ich obiekcie głównym.

databricks apps update-permissions APP_NAME [flags]

Arguments

APP_NAME

    Aplikacja, dla której chcesz uzyskać uprawnienia lub zarządzać nimi.

Opcje

--json JSON

    Wbudowany ciąg JSON lub @path do pliku JSON z treścią żądania.

Flagi globalne

Examples

Poniższy przykład aktualizuje uprawnienia przy użyciu konfiguracji JSON:

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

Flagi globalne

--debug

  Czy włączyć rejestrowanie debugowania.

-h lub --help

    Wyświetl pomoc dla Databricks CLI lub dla powiązanej grupy poleceń czy pojedynczego polecenia.

--log-file struna

    Ciąg reprezentujący plik do zapisywania dzienników wyjściowych. Jeśli ta flaga nie zostanie określona, wartością domyślną jest zapisywanie dzienników wyjściowych w programie stderr.

--log-format formatowanie

    Typ text formatu dziennika lub json. Wartość domyślna to text.

--log-level struna

    Ciąg reprezentujący poziom formatu zapisu dziennika. Jeśli nie zostanie określony, poziom formatu dziennika jest wyłączony.

-o, --output typ

    Typ text danych wyjściowych polecenia lub json. Wartość domyślna to text.

-p, --profile struna

    Nazwa profilu w ~/.databrickscfg pliku do uruchomienia polecenia . Jeśli ta flaga nie zostanie określona, zostanie użyty profil o nazwie DEFAULT .

--progress-format formatowanie

    Format wyświetlania dzienników postępu: default, , appendinplacelubjson

-t, --target struna

    Jeśli ma to zastosowanie, element docelowy pakietu do użycia