jobs kommandogrupp

Note

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.

Med jobs kommandogruppen i Databricks CLI kan du skapa, redigera och ta bort jobb. Se Lakeflow Jobs.

databricks-jobb avbryter alla körningar

Avbryt alla aktiva körningar av ett jobb. Körningarna stoppas asynkront, vilket inte förhindrar att nya körningar startas.

databricks jobs cancel-all-runs [flags]

Arguments

None

Options

--all-queued-runs

    Valfri boolesk parameter för att avbryta alla köade körningar.

--job-id int

    Den kanoniska identifieraren för jobbet som ska avbryta alla körningar.

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

Globala flaggor

databricks-jobb avbryt körning

Avbryt en körning.

Avbryter en jobbkörning eller en aktivitetskörning. Körningen avbryts asynkront, vilket innebär att den fortfarande kan pågå när den här begäran har slutförts.

databricks jobs cancel-run RUN_ID [flags]

Arguments

RUN_ID

    Fältet är obligatoriskt.

Options

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

--no-wait

    Vänta inte tills du når tillstånden AVSLUTAD eller ÖVERHOPPAD.

--timeout duration

    maximal tid för att nå TERMINATED eller SKIPPED-tillståndet (standard 20 m 0 s)

Globala flaggor

skapa databricks-jobb

Skapa ett nytt jobb.

databricks jobs create [flags]

Arguments

None

Options

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

Globala flaggor

databricks-jobb tas bort

Ta bort ett jobb.

databricks jobs delete JOB_ID [flags]

Arguments

JOB_ID

    Den kanoniska identifieraren för jobbet som ska tas bort. Fältet är obligatoriskt.

Options

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

Globala flaggor

ta bort databricks-jobb

Ta bort en icke-aktiv körning. Returnerar ett fel om processen är aktiv.

databricks jobs delete-run RUN_ID [flags]

Arguments

RUN_ID

    ID för körningen som ska tas bort.

Options

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

Globala flaggor

databricks-jobb exportera-kör

Exportera och hämta arbetsuppgiften för jobbet.

databricks jobs export-run RUN_ID [flags]

Arguments

RUN_ID

    Den kanoniska identifieraren för körningen. Fältet är obligatoriskt.

Options

--views-to-export ViewsToExport

    Vilka vyer som ska exporteras. Värden som stöds: ALL, CODE, DASHBOARDS

Globala flaggor

databricks-jobb hämta

Hämtar detaljer för en enskild arbetsuppgift.

Stora matriser i resultatet sidnumreras när de överskrider 100 element. En begäran om ett enda jobb returnerar alla egenskaper för jobbet och de första 100 elementen i matrisegenskaperna (uppgifter, job_clusters, miljöer och parametrar). Använd fältet next_page_token för att söka efter fler resultat och skicka dess värde som page_token i efterföljande begäranden. Om matrisegenskaper har fler än 100 element returneras ytterligare resultat för efterföljande begäranden. Matriser utan ytterligare resultat kommer att vara tomma på senare sidor.

databricks jobs get JOB_ID [flags]

Arguments

JOB_ID

    Den kanoniska identifieraren för jobbet som du vill hämta information om. Fältet är obligatoriskt.

Options

--page-token string

    Använd next_page_token som returnerades från föregående GetJob-svar för att begära nästa sida i jobbets arrayegenskaper.

Globala flaggor

databricks-jobb get-run

Hämtar metadata för en jobbkörning.

Stora matriser i resultatet sidnumreras när de överskrider 100 element. En begäran om en enskild körning returnerar alla egenskaper för den körningen och de första 100 elementen i matrisegenskaperna (tasks, job_clusters, job_parameters och repair_history). Använd fältet next_page_token för att söka efter fler resultat och skicka dess värde som page_token i efterföljande begäranden. Om matrisegenskaper har fler än 100 element returneras ytterligare resultat för efterföljande begäranden. Matriser utan ytterligare resultat kommer att vara tomma på senare sidor.

databricks jobs get-run RUN_ID [flags]

Arguments

RUN_ID

    Den kanoniska identifieraren för körningen som metadata ska hämtas för. Fältet är obligatoriskt.

Options

--include-history

    Inkludera reparationshistoriken i svaret.

--include-resolved-values

    Inkludera lösta parametervärden i svaret.

--page-token string

    Använd next_page_token som returnerades från föregående GetRun-svar för att begära nästa sida i körningens matrisegenskaper.

Globala flaggor

databricks-jobb get-run-output

Hämta utdata och metadata för en enskild aktivitetskörning. När en notebook-uppgift returnerar ett värde via anropet dbutils.notebook.exit() kan du använda det här kommandot för att hämta det värdet. Databricks begränsar det här API:et till att returnera de första 5 MB av utdata. Om du vill returnera ett större resultat kan du lagra jobbresultat i en molnlagringstjänst.

Det här kommandot verifierar att parametern run_id är giltig och returnerar http-statuskoden 400 om parametern run_id är ogiltig. Körningar tas bort automatiskt efter 60 dagar. Om du vill referera till dem längre än 60 dagar måste du spara gamla körningsresultat innan de upphör att gälla.

databricks jobs get-run-output RUN_ID [flags]

Arguments

RUN_ID

    Den kanoniska identifieraren för körningen.

Options

Globala flaggor

databricks-jobblista

Hämta en lista över jobb.

databricks jobs list [flags]

Arguments

None

Options

--expand-tasks

    Om uppgifts- och klusterinformation ska inkluderas i svaret.

--limit int

    Antalet jobb som ska returneras.

--name string

    Ett filter i listan baserat på det exakta (skiftlägesokänsliga) jobbnamnet.

--offset int

    Förskjutningen av det första jobbet som ska returneras i förhållande till det senast skapade jobbet.

--page-token string

    Använd next_page_token eller prev_page_token som returnerades från föregående begäran för att lista nästa eller föregående sida med jobb.

Globala flaggor

databricks-jobb lista-körningar

Lista jobbkörningar i fallande ordning efter starttid.

databricks jobs list-runs [flags]

Arguments

None

Options

--active-only

    Om active_only är sant inkluderas endast aktiva körningar i resultatet. I annat fall visas både aktiva och slutförda körningar.

--completed-only

    Om completed_only är sant inkluderas endast slutförda körningar i resultatet. I annat fall visas både aktiva och slutförda körningar.

--expand-tasks

    Om uppgifts- och klusterinformation ska inkluderas i svaret.

--job-id int

    Det jobb för vilket listan körs.

--limit int

    Antalet körningar som ska returneras.

--offset int

    Förskjutningen av den första körningen som ska returneras i förhållande till den senaste körningen.

--page-token string

    Använd next_page_token eller prev_page_token som returnerades från föregående begäran för att visa en lista över nästa respektive föregående sida med körningar.

--run-type RunType

    Vilken typ av körningar som ska returneras. Värden som stöds: [JOB_RUN, SUBMIT_RUN, WORKFLOW_RUN]

--start-time-from int

    Visa körningar som startade vid eller efter det här värdet.

--start-time-to int

    Visa körningar som startade vid eller före det här värdet.

Globala flaggor

återställningskörning av databricks-jobb

Kör en eller flera jobbuppgifter igen. Uppgifter körs igen som en del av den ursprungliga jobb körningen. De använder de aktuella jobb- och uppgiftsinställningarna och kan ses i historiken för den ursprungliga jobbexekveringen.

databricks jobs repair-run RUN_ID [flags]

Arguments

RUN_ID

    Jobbets körnings-ID för körningen som ska repareras. Körningen får inte pågå.

Options

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

--latest-repair-id int

    ID för den senaste reparationen.

--no-wait

    Vänta inte tills du når tillstånden AVSLUTAD eller ÖVERHOPPAD.

--performance-target PerformanceTarget

    Prestandaläget på ett serverlöst jobb. Värden som stöds: [PERFORMANCE_OPTIMIZED, STANDARD]

--rerun-all-failed-tasks

    Om sant, reparera alla uppgifter som inte lyckades.

--rerun-dependent-tasks

    Om sant, reparera alla uppgifter som är beroende av uppgifterna i rerun_tasks, även om de tidigare lyckades.

--timeout duration

    maximal tid för att nå TERMINATED eller SKIPPED-tillståndet (standard 20 m 0 s)

Globala flaggor

Återställ databricks-jobb

Skriv över alla inställningar för det angivna jobbet. databricks jobs update Använd kommandot för att uppdatera jobbinställningarna delvis.

databricks jobs reset [flags]

Arguments

None

Options

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

Globala flaggor

databricks-jobb starta nu

Kör ett jobb och returnera run_id för den utlösta körningen.

databricks jobs run-now JOB_ID [flags]

Arguments

JOB_ID

    ID för uppgiften som ska köras

Options

--idempotency-token string

    En valfri token för att garantera idempotens vid förfrågningar om att köra jobb.

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

--no-wait

    Vänta inte tills du når tillstånden AVSLUTAD eller ÖVERHOPPAD.

--performance-target PerformanceTarget

    Prestandaläget på ett serverlöst jobb. Värden som stöds: [PERFORMANCE_OPTIMIZED, STANDARD]

--timeout duration

    maximal tid för att nå TERMINATED eller SKIPPED-tillståndet (standard 20 m 0 s)

Globala flaggor

databricks-jobb skicka

Skapa och utlösa en engångskörning. På så sätt kan du skicka en arbetsbelastning direkt utan att skapa ett jobb.

databricks jobs submit [flags]

Arguments

None

Options

--budget-policy-id string

    Användaren angav id för den budgetprincip som ska användas för den här engångskörningen.

--idempotency-token string

    En valfri token som kan användas för att garantera idempotensen för jobbkörningsbegäranden.

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

--no-wait

    Vänta inte tills du når tillstånden AVSLUTAD eller ÖVERHOPPAD.

--run-name string

    Ett valfritt namn för körningen.

--timeout duration

    maximal tid för att nå TERMINATED eller SKIPPED-tillståndet (standard 20 m 0 s)

--timeout-seconds int

    En valfri tidsgräns som tillämpas för varje körning av den här uppgiften.

Globala flaggor

Databricks-jobb uppdateras

Lägg till, uppdatera eller ta bort specifika inställningar för ett befintligt jobb. Använd reset för att skriva över alla jobbinställningar.

databricks jobs update JOB_ID [flags]

Arguments

JOB_ID

    Den kanoniska identifieraren för jobbet som ska uppdateras. Fältet är obligatoriskt.

Options

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

Globala flaggor

databricks-jobb hämta behörighetsnivåer

Hämta jobbbehörighetsnivåer.

databricks jobs get-permission-levels JOB_ID [flags]

Arguments

JOB_ID

    Jobbet som behörigheter ska erhållas eller hanteras för.

Options

Globala flaggor

get-permissions för databricks-jobb

Hämta behörigheter för ett jobb. Jobb kan ärva behörigheter från sina rotobjekt.

databricks jobs get-permissions JOB_ID [flags]

Arguments

JOB_ID

    Jobbet som behörigheter ska erhållas eller hanteras för.

Options

Globala flaggor

databricks-jobb ställ-in-behörigheter

Ange jobbbehörigheter.

Anger behörigheter för ett objekt och ersätter befintliga behörigheter om de finns. Tar bort alla direktbehörigheter om inga har angetts. Objekt kan ärva behörigheter från sina rotobjekt.

databricks jobs set-permissions JOB_ID [flags]

Arguments

JOB_ID

    Jobbet som behörigheter ska erhållas eller hanteras för.

Options

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

Globala flaggor

uppdateringsbehörigheter för databricks-jobb

Uppdatera behörigheterna för ett jobb. Jobb kan ärva behörigheter från sina rotobjekt.

databricks jobs update-permissions JOB_ID [flags]

Arguments

JOB_ID

    Jobbet som behörigheter ska erhållas eller hanteras för.

Options

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

Globala flaggor

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