Microsoft Fabric RunNotebook
CertifiedRun a Microsoft Fabric Notebook
Microsoft Fabric RunNotebook
Run a Microsoft Fabric Notebook
Submits a Fabric Notebook job using the item job scheduler API and optionally waits for completion. Defaults: wait=true, pollFrequency=PT5S, timeout=PT1H.
type: io.kestra.plugin.microsoft.fabric.data.engineering.RunNotebookExamples
id: fabric_run_notebook
namespace: company.team
tasks:
- id: run_notebook
type: io.kestra.plugin.microsoft.fabric.data.engineering.RunNotebook
tenantId: "{{ secret('FABRIC_TENANT_ID') }}"
clientId: "{{ secret('FABRIC_CLIENT_ID') }}"
clientSecret: "{{ secret('FABRIC_CLIENT_SECRET') }}"
workspaceId: "your-workspace-id"
notebookId: "your-notebook-item-id"
parameters:
input_path: "abfss://workspace@onelake.dfs.fabric.microsoft.com/lakehouse/Files/input.csv"
Properties
notebookId *Requiredstring
Notebook ID
Microsoft Fabric Notebook item GUID within the workspace
workspaceId *Requiredstring
Workspace ID
Microsoft Fabric workspace GUID
clientId string
Client ID
Service principal client (application) ID
clientSecret string
Client Secret
Service principal client secret. When both clientId and clientSecret are provided, service principal authentication is used; otherwise DefaultAzureCredential is used.
parameters object
{}Execution parameters
Key/value parameters passed to the job execution
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
pollFrequency string
PT5SPoll frequency
Interval between status checks when wait=true
tenantId string
Tenant ID
Azure Active Directory tenant ID for authentication
timeout string
PT1HTimeout
Maximum time to wait for completion; throws TimeoutException when exceeded
wait booleanstring
trueWait for completion
Poll until the job reaches a terminal state; returns jobInstanceId immediately when false
Outputs
jobInstanceId string
Job instance ID
Unique ID of the notebook job instance
status string
Final status
Terminal status of the notebook job
