Dela via


account workspaces kommandogrupp

Anmärkning

Den här informationen gäller för Databricks CLI-versionerna 0.205 och senare. Databricks CLI finns i offentlig förhandsversion.

Databricks CLI-användning omfattas av Databricks-licensen och Databricks sekretessmeddelande, inklusive eventuella användningsdatabestämmelser.

Kommandogruppen account workspaces i Databricks CLI innehåller kommandon för att hantera arbetsytor för ditt konto. En Databricks-arbetsyta är en miljö för åtkomst till alla dina Databricks-tillgångar. Arbetsytan organiserar objekt (notebook-filer, bibliotek och experiment) i mappar och ger åtkomst till data och beräkningsresurser som kluster och jobb. Se Skapa en arbetsyta.

Anmärkning

Dessa kommandon är tillgängliga om ditt konto finns på E2-versionen av plattformen eller på en anpassad plan som tillåter flera arbetsytor per konto.

skapa databricks-kontoarbetsytor

Skapa en ny arbetsyta med hjälp av en konfiguration av autentiseringsuppgifter och en lagringskonfiguration, en valfri nätverkskonfiguration (om du använder en kundhanterad VPC), en valfri nyckelkonfiguration för hanterade tjänster (om du använder kundhanterade nycklar för hanterade tjänster) och en valfri konfiguration av lagringsnyckeln (om du använder kundhanterade nycklar för lagring).

Viktigt!

Den här åtgärden är asynkron. Ett svar med HTTP-statuskod 200 innebär att begäran har godkänts och pågår, men innebär inte att arbetsytan har distribuerats och körs. Den inledande arbetsytans status är vanligtvis ETABLERING. Använd fältet arbetsyte-ID (workspace_id) i svaret för att identifiera den nya arbetsytan och göra upprepade GET begäranden med arbetsyte-ID:t och kontrollera dess status. Arbetsytan blir tillgänglig när statusen ändras till RUNNING.

databricks account workspaces create [flags]

Alternativ

--workspace-name string

    Arbetsytans läsbara namn.

--deployment-name string

    Distributionsnamnet definierar en del av underdomänen för arbetsytan.

--aws-region string

    AWS-regionen för arbetsytan.

--cloud string

    Molnnamnet.

--location string

    Google Cloud-regionen för arbetsytans dataplan i ditt Google-konto (till exempel us-east4).

--credentials-id string

    ID för arbetsytans konfigurationsobjekt för autentiseringsuppgifter.

--storage-configuration-id string

    ID för arbetsytans lagringskonfigurationsobjekt.

--network-id string

    ID för arbetsytans nätverkskonfigurationsobjekt.

--managed-services-customer-managed-key-id string

    ID:t för arbetsytans konfigurationsobjekt för krypteringsnyckel för hanterade tjänster.

--storage-customer-managed-key-id string

    ID för arbetsytans konfigurationsobjekt för lagringskrypteringsnyckel.

--private-access-settings-id string

    ID för arbetsytans objekt för privata åtkomstinställningar.

--network-connectivity-config-id string

    Objekt-ID för konfiguration av nätverksanslutning.

--compute-mode CustomerFacingComputeMode

    Om beräkningsläget är SERVERLÖST skapas en serverlös arbetsyta. Värden som stöds: HYBRID, SERVERLESS.

--pricing-tier PricingTier

    Prisnivån för arbetsytan. Värden som stöds: COMMUNITY_EDITION, DEDICATED, ENTERPRISE, PREMIUM, STANDARD, UNKNOWN.

--no-wait

    Vänta inte med att nå körningstillståndet.

--timeout duration

    Maximal tid för att nå KÖRNINGstillstånd (standard 20 m0s).

--json JSON

    Den infogade JSON-strängen eller @path till JSON-filen med begärandetexten

Globala flaggor

Exempel

I följande exempel skapas en arbetsyta med JSON:

databricks account workspaces create --json '{"workspace_name": "my-workspace", "deployment_name": "my-workspace-deployment", "aws_region": "us-west-2", "credentials_id": "cred-abc123", "storage_configuration_id": "storage-xyz789"}'

I följande exempel skapas en arbetsyta med hjälp av en JSON-fil:

databricks account workspaces create --json @workspace.json

I följande exempel skapas en arbetsyta med kommandoradsflaggor:

databricks account workspaces create --workspace-name "my-workspace" --deployment-name "my-workspace-deployment" --aws-region "us-west-2" --credentials-id "cred-abc123" --storage-configuration-id "storage-xyz789"

databricks-kontoarbetsytor tas bort

Ta bort en Databricks-arbetsyta som anges av ID.

databricks account workspaces delete WORKSPACE_ID [flags]

Arguments

WORKSPACE_ID

    Ett unikt heltals-ID för arbetsytan.

Alternativ

Globala flaggor

Exempel

I följande exempel tas en arbetsyta bort efter ID:

databricks account workspaces delete 123456789

databricks-kontoarbetsytor hämta

Hämta information, inklusive status för en Databricks-arbetsyta, som anges av ID. I svaret anger fältet workspace_status aktuell status. När den första arbetsytan har skapats (vilket är asynkront) gör du upprepade GET begäranden med arbetsyte-ID:t och kontrollerar dess status. Arbetsytan blir tillgänglig när statusen ändras till RUNNING.

databricks account workspaces get WORKSPACE_ID [flags]

Arguments

WORKSPACE_ID

    Ett unikt heltals-ID för arbetsytan.

Alternativ

Globala flaggor

Exempel

I följande exempel hämtas en arbetsyta efter ID:

databricks account workspaces get 123456789

lista över databricks-kontoarbetsytor

Lista Databricks-arbetsytor för ett konto.

databricks account workspaces list [flags]

Alternativ

Globala flaggor

Exempel

I följande exempel visas alla arbetsytor:

databricks account workspaces list

uppdatering av databricks-kontoarbetsytor

Uppdatera en konfiguration av arbetsytan.

databricks account workspaces update WORKSPACE_ID [flags]

Arguments

WORKSPACE_ID

    Ett unikt heltals-ID för arbetsytan.

Alternativ

--workspace-name string

    Arbetsytans läsbara namn.

--deployment-name string

    Distributionsnamnet för arbetsytan.

--aws-region string

    AWS-regionen för arbetsytan.

--cloud string

    Molnnamnet.

--location string

    Google Cloud-regionen för arbetsytans dataplan i ditt Google-konto (till exempel us-east4).

--credentials-id string

    ID för arbetsytans konfigurationsobjekt för autentiseringsuppgifter.

--storage-configuration-id string

    ID för arbetsytans lagringskonfigurationsobjekt.

--network-id string

    Om den här arbetsytan är VPC för BYO fylls network_id i.

--managed-services-customer-managed-key-id string

    ID för nyckelkonfigurationen för kryptering av hanterade tjänster.

--storage-customer-managed-key-id string

    ID för nyckelkonfigurationen för kryptering av lagring av arbetsytor.

--private-access-settings-id string

    ID för arbetsytans objekt för privata åtkomstinställningar.

--network-connectivity-config-id string

    Objekt-ID för konfiguration av nätverksanslutning.

--expected-workspace-status WorkspaceStatus

    Ett klientägt fält som används för att ange arbetsytans status som klienten förväntar sig att vara i. Värden som stöds: BANNED, CANCELLING, FAILED, NOT_PROVISIONED, PROVISIONING, RUNNING.

--update-mask string

    Fältmasken måste vara en enda sträng med flera fält avgränsade med kommatecken (inga blanksteg).

--no-wait

    Vänta inte med att nå körningstillståndet.

--timeout duration

    Maximal tid för att nå KÖRNINGstillstånd (standard 20 m0s).

--json JSON

    Den infogade JSON-strängen eller @path till JSON-filen med begärandetexten

Globala flaggor

Exempel

I följande exempel uppdateras ett namn på arbetsytan:

databricks account workspaces update 123456789 --workspace-name "updated-workspace-name"

I följande exempel uppdateras en arbetsyta med JSON:

databricks account workspaces update 123456789 --json '{"workspace_name": "updated-workspace-name", "credentials_id": "cred-new123"}'

I följande exempel uppdateras en arbetsyta med hjälp av en JSON-fil:

databricks account workspaces update 123456789 --json @update-workspace.json

Globala flaggor

--debug

  Om felsökningsloggning ska aktiveras.

-h eller --help

    Visa hjälp för Databricks CLI eller den relaterade kommandogruppen eller det relaterade kommandot.

--log-file sträng

    En sträng som representerar filen som utdataloggarna ska skrivas till. Om den här flaggan inte anges är standardvärdet att skriva utdataloggar till stderr.

--log-format Format

    Loggformattypen, text eller json. Standardvärdet är text.

--log-level sträng

    En sträng som representerar loggformatnivån. Om det inte anges inaktiveras loggformatnivån.

-o, --output typ

    Kommandots utdatatyp, text eller json. Standardvärdet är text.

-p, --profile sträng

    Namnet på profilen i ~/.databrickscfg-filen som ska användas för att köra kommandot. Om den här flaggan inte anges används den namngivna DEFAULT profilen om den finns.

--progress-format Format

    Formatet för att visa förloppsloggar: default, append, inplaceeller json

-t, --target sträng

    Om tillämpligt, paketmålet som ska användas