Vad är en referens för dynamiskt värde?

Referenser till dynamiskt värde beskriver en samling variabler som är tillgängliga när jobb och uppgifter konfigureras. Använd referenser för dynamiskt värde för att konfigurera villkorsstyrda instruktioner för aktiviteter eller för att skicka information som parametrar eller argument.

Referenser till dynamiskt värde innehåller information som:

• Konfigurerade värden för jobbet, inklusive jobbnamn, uppgiftsnamn och utlösartyp.
• Genererade metadata om jobbet, inklusive jobb-ID, körnings-ID och starttid för jobbkörningen.
• Information om hur många reparationsförsök ett jobb har gjort eller försöker utföra en aktivitet igen har körts.
• Resultattillståndet för en angiven aktivitet.
• Värden som konfigurerats med hjälp av jobbparametrar, aktivitetsparametrar eller ange med hjälp av aktivitetsvärden.

Använda referenser för dynamiskt värde

Använd referenser för dynamiskt värde när du konfigurerar jobb eller uppgifter. Du kan inte direkt referera till dynamiska värdereferenser från tillgångar som konfigurerats med hjälp av uppgifter som notebook-filer, frågor eller JAR:er. Referenser för dynamiskt värde måste definieras med hjälp av parametrar eller fält som skickar kontexten till aktiviteter.

Dynamiska värdereferenser använder dubbla klammerparenteser ({{ }}). När ett jobb eller en aktivitet körs ersätter en strängliteral referensen för det dynamiska värdet. Om du till exempel konfigurerar följande nyckel/värde-par som en aktivitetsparameter:

{"job_run_id": "job_{{job.run_id}}"}

Om ditt körnings-ID är 550315892394120utvärderas värdet för job_run_id till job_550315892394120.

Använda referenser för dynamiskt värde i jobbgränssnittet

Fält som accepterar referenser för dynamiskt värde ger en genväg för att infoga tillgängliga referenser för dynamiskt värde. Klicka på { } för att se den här listan och infoga den i det angivna fältet.

Använda referenser för dynamiskt värde i ett jobb-JSON

Använd {{ }} syntax för att använda dynamiska värden i JSON-jobbdefinitioner som används av Databricks CLI och REST API.

Jobb- och aktivitetsparametrar har olika syntax, och syntaxen för aktivitetsparametern varierar beroende på aktivitetstyp.

I följande exempel visas den partiella JSON-syntaxen för att konfigurera jobbparametrar med hjälp av referenser för dynamiskt värde:

{
  "parameters": [
    {
      "name": "my_job_id",
      "default": "{{job.id}}"
    },
    {
      "name": "run_date",
      "default": "{{job.start_time.iso_date}}"
    }
  ]
}

I följande exempel visas den partiella JSON-syntaxen för att konfigurera notebook-uppgiftsparametrar med hjälp av en referens för dynamiskt värde:

{
  "notebook_task": {
    "base_parameters": {
      "workspace_id": "workspace_{{workspace.id}}",
      "file_arrival_location": "{{job.trigger.file_arrival.location}}"
    }
  }
}

Granska parametrar för en jobbkörning

När en uppgift har slutförts kan du se lösta parametervärden under Parametrar på sidan körningsinformation. Se Visa information om jobbkörning.

Värdereferenser som stöds

Följande referenser för dynamiskt värde stöds:

Du kan ange dessa referenser med valfri uppgift. Se Konfigurera aktivitetsparametrar.

Du kan också skicka parametrar mellan aktiviteter i ett jobb med aktivitetsvärden. Se Använda aktivitetsvärden för att skicka information mellan aktiviteter.

Alternativ för datum- och tidsvärden

Använd följande argument för att ange returvärdet från tidsbaserade parametervariabler. Alla returvärden baseras på en tidsstämpel i UTC-tidszonen.

Inaktuella referenser för dynamiskt värde

Följande dynamiska värdereferenser är inaktuella. Den rekommenderade ersättningsreferensen ingår i beskrivningen av varje variabel.