az synapse spark-job-definition

Manage spark job definitions in a synapse workspace.

Commands

Name	Description	Type	Status
az synapse spark-job-definition create	Create a spark job definition.	Core	GA
az synapse spark-job-definition delete	Delete a spark job definition.	Core	GA
az synapse spark-job-definition list	List spark job definitions.	Core	GA
az synapse spark-job-definition show	Get a spark job definition.	Core	GA
az synapse spark-job-definition update	Update a spark job definition.	Core	GA
az synapse spark-job-definition wait	Place the CLI in a waiting state until a condition of a spark job definition is met.	Core	GA

az synapse spark-job-definition create

Create a spark job definition.

az synapse spark-job-definition create --file
                                       --name
                                       --workspace-name
                                       [--folder-path]
                                       [--no-wait]

Examples

Create a spark job definition. Pay attention to add "@" at the front of the file path as the best practice for complex arguments like JSON string.

az synapse spark-job-definition create --workspace-name testsynapseworkspace \
  --name testsjdname --file @"path/test.json" --folder-path 'folder/subfolder'

Required Parameters

--file

Properties may be supplied from a JSON file using the @{path} syntax or a JSON string.

--name -n

The spark job definition name.

--workspace-name

The workspace name.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--folder-path

The folder that this spark job definition is in. If not specified, it will appear at the root level. Eg: folder/subfolder1.

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az synapse spark-job-definition delete

Delete a spark job definition.

az synapse spark-job-definition delete --name
                                       --workspace-name
                                       [--no-wait]

Examples

Delete a spark job definition.

az synapse spark-job-definition delete --workspace-name testsynapseworkspace \
  --name testsjdname

Required Parameters

--name -n

The spark job definition name.

--workspace-name

The workspace name.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az synapse spark-job-definition list

List spark job definitions.

az synapse spark-job-definition list --workspace-name

Examples

List spark job definitions.

az synapse spark-job-definition list --workspace-name testsynapseworkspace

Required Parameters

--workspace-name

The workspace name.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az synapse spark-job-definition show

Get a spark job definition.

az synapse spark-job-definition show --name
                                     --workspace-name

Examples

Get a spark job definition.

az synapse spark-job-definition show --workspace-name testsynapseworkspace \
  --name testsjdname

Required Parameters

--name -n

The spark job definition name.

--workspace-name

The workspace name.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az synapse spark-job-definition update

Update a spark job definition.

az synapse spark-job-definition update --file
                                       --name
                                       --workspace-name
                                       [--folder-path]
                                       [--no-wait]

Examples

Update a spark job definition. Pay attention to add "@" at the front of the file path as the best practice for complex arguments like JSON string.

az synapse spark-job-definition update --workspace-name testsynapseworkspace \
  --name testsjdname --file @"path/test.json" --folder-path 'folder/subfolder'

Required Parameters

--file

Properties may be supplied from a JSON file using the @{path} syntax or a JSON string.

--name -n

The spark job definition name.

--workspace-name

The workspace name.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--folder-path

The folder that this spark job definition is in. If not specified, it will appear at the root level. Eg: folder/subfolder1.

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az synapse spark-job-definition wait

Place the CLI in a waiting state until a condition of a spark job definition is met.

az synapse spark-job-definition wait --name
                                     --workspace-name
                                     [--created]
                                     [--custom]
                                     [--deleted]
                                     [--exists]
                                     [--interval]
                                     [--timeout]
                                     [--updated]

Required Parameters

--name -n

The spark job definition name.

--workspace-name

The workspace name.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

Wait until created with 'provisioningState' at 'Succeeded'.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--custom

Wait until the condition satisfies a custom JMESPath query. E.g. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Property	Value
Parameter group:	Wait Condition Arguments

--deleted

Wait until deleted.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--exists

Wait until the resource exists.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

--interval

Polling interval in seconds.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	30

--timeout

Maximum wait in seconds.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	3600

--updated

Wait until updated with provisioningState at 'Succeeded'.

Property	Value
Parameter group:	Wait Condition Arguments
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False