Install client tools for deploying and managing Azure Arc enabled data services

Important

If you are updating to a new monthly release, please be sure to also update to the latest version of Azure Data Studio, the Azure Data CLI (azdata) tool, and the Azure Data CLI (azdata) and Azure Arc extensions for Azure Data Studio.

This document walks you through the steps for installing the Azure Data CLI (azdata), Azure Data Studio, Azure CLI (az), and the Kubernetes CLI tool (kubectl) on your client machine.

Note

As a preview feature, the technology presented in this article is subject to Supplemental Terms of Use for Microsoft Azure Previews.

For current limitations, check the known issues in the release notes.

Tools for creating and managing Azure Arc enabled data services

The following table lists common tools required for creating and managing Azure Arc enabled data services, and how to install those tools:

Tool Required Description Installation
Azure Data CLI (azdata) Yes Command-line tool for installing and managing a big data cluster. Azure Data CLI (azdata) also includes a command line utility to connect to and query Azure SQL and SQL Server instances and Postgres servers using the commands azdata sql query (run a single query from the command line), azdata sql shell (an interactive shell), azdata postgres query and azdata postgres shell. Install
Azure Data Studio Yes Rich experience tool for connecting to and querying a variety of databases including Azure SQL, SQL Server, PostrgreSQL, and MySQL. Extensions to Azure Data Studio provide an administration experience for Azure Arc enabled data services. Install
Azure Data CLI (azdata) extension for Azure Data Studio Yes Extension for Azure Data Studio that will install Azure Data CLI (azdata) if you don't already have it. Install from extensions gallery in Azure Data Studio.
Azure Arc extension for Azure Data Studio Yes Extension for Azure Data Studio that provides a management experience for Azure Arc enabled data services. There is a dependency on the Azure Data CLI (azdata) extension for Azure Data Studio. Install from extensions gallery in Azure Data Studio.
PostgreSQL extension in Azure Data Studio No PostgreSQL extension for Azure Data Studio that provides management capabilities for PostgreSQL. Install from extensions gallery in Azure Data Studio.
Azure CLI (az)1 Yes Modern command-line interface for managing Azure services. Used with AKS deployments and to upload Azure Arc enabled data services inventory and billing data to Azure. (More info). Install
Kubernetes CLI (kubectl)2 Yes Command-line tool for managing the Kubernetes cluster (More info). Windows | Linux
curl 3 Required for some sample scripts. Command-line tool for transferring data with URLs. Windows | Linux: install curl package
oc Required for Red Hat OpenShift and Azure Redhat OpenShift deployments. oc is the Open Shift command line interface (CLI). Installing the CLI

1 You must be using Azure CLI version 2.0.4 or later. Run az --version to find the version if needed.

2 You must use kubectl version 1.13 or later. Also, the version of kubectl should be plus or minus one minor version of your Kubernetes cluster. If you want to install a specific version on kubectl client, see Install kubectl binary via curl (on Windows 10, use cmd.exe and not Windows PowerShell to run curl).

3 If you are using PowerShell, curl is an alias to the Invoke-WebRequest cmdlet.

Next steps

Create the Azure Arc data controller