azdata bdc
Applies to: 
Azure Data CLI (azdata)
The following article provides reference for the sql commands in the azdata tool. For more information about other azdata commands, see azdata reference.
Commands
| Command | Description |
|---|---|
| azdata bdc create | Create Big Data Cluster. |
| azdata bdc delete | Delete Big Data Cluster. |
| azdata bdc upgrade | Update the images deployed in each container in the SQL Server Big Data Cluster. |
| azdata bdc config | Configuration commands. |
| azdata bdc endpoint | Endpoint commands. |
| azdata bdc debug | Debug commands. |
| azdata bdc status | Big Data Clusters status commands. |
| azdata bdc control | Control service commands. |
| azdata bdc sql | Sql service commands. |
| azdata bdc hdfs | Hdfs service commands. |
| azdata bdc spark | Spark service commands. |
| azdata bdc gateway | Gateway service commands. |
| azdata bdc app | App service commands. |
| azdata bdc hdfs | The HDFS module provides commands to access an HDFS file system. |
| azdata bdc settings | Big Data Clusters settings commands. |
| azdata bdc spark | The Spark commands allow the user to interact with the Spark system by creating and managing sessions, statements, and batches. |
| azdata bdc rotate | This command rotates the passwords of autogenerated AD accounts in a big data cluster. For more information, see AD password rotation overview. |
azdata bdc create
Create a SQL Server Big Data Cluster - Kubernetes configuration is required on your system along with the following environment variables ['AZDATA_USERNAME', 'AZDATA_PASSWORD'].
azdata bdc create [--name -n]
[--config-profile -c]
[--accept-eula -a]
[--node-label -l]
[--force -f]
Examples
Guided SQL Server Big Data Clusters deployment experience - you will receive prompts for needed values.
azdata bdc create
Big Data Clusters deployment with arguments and custom config profile that was initialized via azdata bdc config init.
azdata bdc create --accept-eula yes --config-profile ./path/to/config/profile
Big Data Clusters deployment with custom cluster name specified and a default config profile aks-dev-test.
azdata bdc create --name <cluster_name> --accept-eula yes --config-profile aks-dev-test
Big Data Clusters deployment with arguments - no prompts will be given as the --force flag is used.
azdata bdc create --accept-eula yes --config-profile aks-dev-test --force
Optional Parameters
--name -n
Big data cluster name, used for kubernetes namespaces.
--config-profile -c
Big data cluster config profile, used for deploying the cluster: ['kubeadm-dev-test', 'kubeadm-prod', 'openshift-prod', 'aks-dev-test-ha', 'aks-dev-test', 'aro-dev-test', 'openshift-dev-test', 'aro-dev-test-ha']
--accept-eula -a
Do you accept the license terms? [yes/no]. If you do not want to use this arg, you may set the environment variable ACCEPT_EULA to 'yes'. The license terms for azdata can be viewed at https://aka.ms/eula-azdata-en.
--node-label -l
Big data cluster node label, used to designate what nodes to deploy to.
--force -f
Force create, the user will not be prompted for any values and all issues will be printed as partof stderr.
Global Arguments
--debug
Increase logging verbosity to show all debug logs.
--help -h
Show this help message and exit.
--output -o
Output format. Allowed values: json, jsonc, table, tsv. Default: json.
--query -q
JMESPath query string. See http://jmespath.org/ for more information and examples.
--verbose
Increase logging verbosity. Use --debug for full debug logs.
azdata bdc delete
Delete the SQL Server Big Data Cluster - Kubernetes configuration is required on your system.
azdata bdc delete --name -n
[--force -f]
Examples
Big Data Clusters delete.
azdata bdc delete --name <cluster_name>
Required Parameters
--name -n
Big data cluster name, used for kubernetes namespace.
Optional Parameters
--force -f
Force delete big data cluster.
Global Arguments
--debug
Increase logging verbosity to show all debug logs.
--help -h
Show this help message and exit.
--output -o
Output format. Allowed values: json, jsonc, table, tsv. Default: json.
--query -q
JMESPath query string. See http://jmespath.org/ for more information and examples.
--verbose
Increase logging verbosity. Use --debug for full debug logs.
azdata bdc upgrade
Update the images deployed in each container in the SQL Server Big Data Cluster. The images updated are based on the docker image passed in. If the updated images are from a different docker image repository than the currently deployed images, then the "repository" parameter is also required.
azdata bdc upgrade --name -n
--tag -t
[--repository -r]
[--controller-timeout -k]
[--stability-threshold -s]
[--component-timeout -p]
[--force -f]
Examples
Big Data Clusters upgrade to a new image tag "cu2" from the same repository.
azdata bdc upgrade -t cu2
Big Data Clusters upgrade to a new images with tag "cu2" from a new repository "foo/bar/baz".
azdata bdc upgrade -t cu2 -r foo/bar/baz
Big Data Clusters upgrade to a new images with tag "cu2" from the same repository.The upgrade will wait 30 minutes for the controller to upgrade and 30 minutes for the controller db to upgrade. It will then wait for the controller and controller db to run for three minutes without crashing upgrading the rest of the cluster. Each subsequent phase of the upgrade will have forty minutes to complete.
azdata bdc upgrade -t cu2 --controller-timeout=30 --component-timeout=40 --stability-threshold=3
Required Parameters
--name -n
Big data cluster name, used for kubernetes namespaces.
--tag -t
The target docker image tag to upgrade all container in the cluster to.
Optional Parameters
--repository -r
The docker repository to have all containers in the cluster pull their images from.
--controller-timeout -k
The number of minutes to wait for the controller or controller database to upgrade before rolling back the upgrade.
--stability-threshold -s
The number of minutes to wait after an upgrade before marking it as stable.
--component-timeout -p
The number of minutes to wait for each phase of the upgrade (after controller upgrade) to complete before pausing the upgrade.
--force -f
If present, ignores the cluster health check before starting the upgrade
Global Arguments
--debug
Increase logging verbosity to show all debug logs.
--help -h
Show this help message and exit.
--output -o
Output format. Allowed values: json, jsonc, table, tsv. Default: json.
--query -q
JMESPath query string. See http://jmespath.org/ for more information and examples.
--verbose
Increase logging verbosity. Use --debug for full debug logs.
Next steps
For more information about other azdata commands, see azdata reference.
For more information about how to install the azdata tool, see Install azdata.
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for