SQL Server Deployment extension for Azure Data Studio

Provides a notebook-based experience to deploy Microsoft SQL Server

New Deployment…

Deployment

SQL Server container image

Run SQL Server container image with docker

Version

SQL Server 2017

SQL Server 2019

Deploy SQL Server 2017 container images

Deploy SQL Server 2019 container images

Container name

SQL Server password

Confirm password

Port

SQL Server on Windows

Run SQL Server on Windows, select a version to get started.

Microsoft Privacy Statement

Deployment configuration

Location of the azdata package used for the install command

SQL Server on Azure Virtual Machine

Create SQL virtual machines on Azure. Best for migrations and applications requiring OS-level access.

Deploy Azure SQL virtual machine

Script to notebook

I accept {0}, {1} and {2}.

Azure SQL VM License Terms

azdata License Terms

Azure information

Azure locations

VM information

Image

VM image SKU

Publisher

Virtual machine name

Size

Storage account

Storage account name

Storage account SKU type

Administrator account

Username

Password

Confirm password

Summary

Azure SQL Database

Create a SQL database, database server, or elastic pool in Azure.

Create in Azure portal

Select

Resource Type

Single Database

Elastic Pool

Database Server

I accept {0}, {1} and {2}.

Azure SQL DB License Terms

azdata License Terms

Azure SQL managed instance

Create a SQL Managed Instance in either Azure or a customer-managed environment

Open in Portal

Resource Type

I accept {0} and {1}.

Azure SQL MI License Terms

Azure SQL Managed Instance provides full SQL Server access and feature compatibility for migrating SQL Servers to Azure, or developing new applications. {0}.

Learn More

Azure Account

Subscription (selected subset)

Change the currently selected subscriptions through the 'Select Subscriptions' action on an account listed in the 'Azure' tree view of the 'Connections' viewlet

Resource Group

Azure Location

Browse

Select

Kube config file path

No cluster context information found

Refresh

Yes

Create a new resource group

New resource group name

Realm

Unknown field type: "{0}"

Options Source with id:{0} is already defined

Value Provider with id:{0} is already defined

No Options Source defined for id: {0}

No Value Provider defined for id: {0}

Attempt to get variable value for unknown variable:{0}

Attempt to get isPassword for unknown variable:{0}

FieldInfo.options was not defined for field type: {0}

FieldInfo.options must be an object if it is not an array

When FieldInfo.options is an object it must have 'optionsType' property

When optionsType is not {0} then it must be {1}

Deployment cannot continue. Azure Data CLI license terms have not yet been accepted. Please accept the EULA to enable the features that requires Azure Data CLI.

Deployment cannot continue. Azure Data CLI license terms were declined.You can either Accept EULA to continue or Cancel this operation

Accept EULA & Select

The '{0}' extension is required to deploy this resource, do you want to install it now?

Install

Installing extension '{0}'...

Unknown extension '{0}'

Select the deployment options

Filter resources...

Categories

There are some errors on this page, click 'Show Details' to view the errors.

Script

Run

View error detail

An error occurred opening the output notebook. {1}{2}.

The task "{0}" has failed.

The task "{0}" failed and no output Notebook was generated.

All

On-premises

SQL Server

Hybrid

PostgreSQL

Cloud

Description

Tool

Status

Version

Required Version

Discovered Path or Additional Information

Required tools

Install tools

Options

Required tool '{0}' [ {1} ] is being installed now.

An error ocurred while loading or parsing the config file:{0}, error is:{1}

Path: {0} is not a file, please select a valid kube config file.

File: {0} not found. Please select a kube config file.

Unexpected error fetching accounts: {0}

Unexpected error fetching available kubectl storage classes : {0}

Unexpected error fetching subscriptions for account {0}: {1}

The selected account '{0}' is no longer available. Click sign in to add it again or select a different account.

Error Details: {0}.

The access token for selected account '{0}' is no longer valid. Please click the sign in button and refresh the account or select a different account.

Unexpected error fetching resource groups for subscription {0}: {1}

{0} doesn't meet the password complexity requirement. For more information: https://docs.microsoft.com/sql/relational-databases/security/password-policy

{0} doesn't match the confirmation password

Deploy Azure SQL VM

Script to Notebook

Please fill out the required fields marked with red asterisks.

Azure settings

Azure Account

Subscription

Resource Group

Region

Virtual machine settings

Virtual machine name

Administrator account username

Administrator account password

Confirm password

Image

Image SKU

Image Version

Size

Click here to learn more about pricing and supported VM sizes

Networking

Configure network settings

New virtual network

Virtual Network

New subnet

Subnet

Public IP

New public ip

Enable Remote Desktop (RDP) inbound port (3389)

SQL Servers settings

SQL connectivity

Port

Enable SQL authentication

Username

Password

Confirm password

Save config files

Script to Notebook

Save config files

Config files saved to {0}

Deploy SQL Server 2019 Big Data Cluster on a new AKS cluster

Deploy SQL Server 2019 Big Data Cluster on an existing AKS cluster

Deploy SQL Server 2019 Big Data Cluster on an existing kubeadm cluster

Deploy SQL Server 2019 Big Data Cluster on an existing Azure Red Hat OpenShift cluster

Deploy SQL Server 2019 Big Data Cluster on an existing OpenShift cluster

Not Installed

Installed

Installing…

Error

Failed

• brew is needed for deployment of the tools and needs to be pre-installed before necessary tools can be deployed

• curl is needed for installation and needs to be pre-installed before necessary tools can be deployed

Could not find 'Location' in the output:

output:

Error installing tool '{0}' [ {1} ].{2}Error: {3}{2}See output channel '{4}' for more details

Error installing tool. See output channel '{0}' for more details

Installation commands completed but version of tool '{0}' could not be detected so our installation attempt has failed. Detection Error: {1}{2}Cleaning up previous installations would help.

Failed to detect version post installation. See output channel '{0}' for more details

A possibly way to uninstall is using this command:{0} >{1}

{0}See output channel '{1}' for more details

Cannot install tool:{0}::{1} as installation commands are unknown for your OS distribution, Please install {0} manually before proceeding

Search Paths for tool '{0}': {1}

Error retrieving version information. See output channel '{0}' for more details

Error retrieving version information.{0}Invalid output received, get version command output: '{1}'

Deploy Azure SQL DB

Script to Notebook

Please fill out the required fields marked with red asterisks.

Azure SQL Database - Azure account settings

Azure account settings

Azure account

Subscription

Server

Resource group

Database settings

Firewall rule name

SQL database name

Database collation

Collation for database

Enter IP addresses in IPv4 format.

Min IP address in firewall IP range

Max IP address in firewall IP range

Min IP address

Max IP address

Create a firewall rule for your local client IP in order to connect to your database through Azure Data Studio after creation is completed.

Create a firewall rule

Runs commands against Kubernetes clusters

kubectl

Unable to parse the kubectl version command output: "{0}"

updating your brew repository for kubectl installation …

installing kubectl …

updating repository information …

getting packages needed for kubectl installation …

downloading and installing the signing key for kubectl …

adding the kubectl repository information …

installing kubectl …

deleting previously downloaded kubectl.exe if one exists …

downloading and installing the latest kubectl.exe …

deleting previously downloaded kubectl if one exists …

downloading the latest kubectl release …

making kubectl executable …

cleaning up any previously backed up version in the install location if they exist …

backing up any existing kubectl in the install location …

moving kubectl into the install location in the PATH …

Open Notebook

Notebook type

The resource type: {0} is not defined

The notebook {0} does not exist

Deployments

>>> {0} … errored out: {1}

>>> Ignoring error in execution and continuing tool deployment

stdout:

stderr:

>>> {0} … exited with code: {1}

>>> {0} … exited with signal: {1}

Download failed, status code: {0}, message: {1}

Service scale settings (Instances)

Service storage settings (GB per Instance)

Features

Yes

Deployment configuration profile

Select the target configuration profile

Note: The settings of the deployment profile can be customized in later steps.

Loading profiles

Loading profiles completed

Deployment configuration profile

Failed to load the deployment profiles: {0}

SQL Server Master

Compute

Data

HDFS + Spark

Service

Data

Logs

Storage type

Basic authentication

Active Directory authentication

High Availability

Feature

Please select a deployment profile.

Please fill out the required fields marked with red asterisks.

Azure settings

Configure the settings to create an Azure Kubernetes Service cluster

Subscription id

Use my default Azure subscription

The default subscription will be used if you leave this field blank.

View available Azure subscriptions

New resource group name

Location

View available Azure locations

AKS cluster name

VM count

VM size

View available VM sizes

The cluster name must consist only of alphanumeric lowercase characters or '-' and must start and end with an alphanumeric character.

Cluster settings

Configure the SQL Server Big Data Cluster settings

Cluster name

Admin username

This username will be used for controller and SQL Server. Username for the gateway will be root.

Password

This password can be used to access the controller, SQL Server and gateway.

Confirm password

Authentication mode

Basic

Active Directory

Docker settings

Registry

Repository

Image tag

Username

Password

Active Directory settings

Organizational unit

Distinguished name for the organizational unit. For example: OU=bdc,DC=contoso,DC=com.

Domain controller FQDNs

Use comma to separate the values.

Fully qualified domain names for the domain controller. For example: DC1.CONTOSO.COM. Use comma to separate multiple FQDNs.

Domain DNS IP addresses

Use comma to separate the values.

Domain DNS servers' IP Addresses. Use comma to separate multiple IP addresses.

Domain DNS name

If not provided, the domain DNS name will be used as the default value.

Cluster admin group

The Active Directory group for cluster admin.

Cluster users

Use comma to separate the values.

The Active Directory users/groups with cluster users role. Use comma to separate multiple users/groups.

Service account username

Domain service account for Big Data Cluster

Service account password

App owners

Use comma to separate the values.

The Active Directory users or groups with app owners role. Use comma to separate multiple users/groups.

App readers

Use comma to separate the values.

The Active Directory users or groups of app readers. Use comma as separator them if there are multiple users/groups.

Subdomain

A unique DNS subdomain to use for this SQL Server Big Data Cluster. If not provided, the cluster name will be used as the default value.

Account prefix

A unique prefix for AD accounts SQL Server Big Data Cluster will generate. If not provided, the subdomain name will be used as the default value. If a subdomain is not provided, the cluster name will be used as the default value.

Password

Service settings

Scale settings

SQL Server master instances

Compute pool instances

Data pool instances

Spark pool instances

Storage pool (HDFS) instances

Include Spark in storage pool

DNS name

Port

Controller

Controller DNS name

Controller port

SQL Server Master

SQL Server Master DNS name

SQL Server Master port

Gateway

Gateway DNS name

Gateway port

Management proxy

Management proxy DNS name

Management proxy port

Application proxy

Application proxy DNS name

Application proxy port

Readable secondary

Readable secondary DNS name

Readable secondary port

Endpoint settings

Use controller settings

By default Controller storage settings will be applied to other services as well, you can expand the advanced storage settings to configure storage for other services.

Controller's data storage class

Controller's data storage claim size

Controller's logs storage class

Controller's logs storage claim size

Storage pool (HDFS)

Storage pool's data storage class

Storage pool's data storage claim size

Storage pool's logs storage class

Storage pool's logs storage claim size

Data pool

Data pool's data storage class

Data pool's data storage claim size

Data pool's logs storage class

Data pool's logs storage claim size

SQL Server master's data storage class

SQL Server master's data storage claim size

SQL Server master's logs storage class

SQL Server master's logs storage claim size

Service name

Storage class for data

Claim size for data (GB)

Storage class for logs

Claim size for logs (GB)

Storage settings

Invalid Spark configuration, you must check the 'Include Spark' checkbox or set the 'Spark pool instances' to at least 1.

Summary

Deployment target

Kube config

Cluster context

Cluster settings

Deployment profile

Cluster name

Controller username

Authentication mode

Active Directory

Basic

Organizational unit

Domain controller FQDNs

Domain DNS IP addresses

Domain DNS name

Cluster admin group

Cluster users

App owners

App readers

Subdomain

Account prefix

Service account username

Azure settings

Subscription id

Default Azure Subscription

Resource group

Location

AKS cluster name

VM size

VM count

Scale settings

SQL Server master instances

Compute pool instances

Data pool instances

Spark pool instances

Storage pool (HDFS) instances

(Spark included)

Service

Storage class for data

Claim size for data (GB)

Storage class for logs

Claim size for logs (GB)

Storage settings

Controller

Storage pool (HDFS)

Data

SQL Server Master

Gateway

Application proxy

Management proxy

Readable secondary

Endpoint settings

Target cluster context

Select the kube config file and then select a cluster context from the list

Please select a cluster context.

Kube config file path

Browse

Cluster Contexts

No cluster information is found in the config file or an error ocurred while loading the config file

Select

Failed to load the config file

Password must be between 12 and 123 characters long.

Password must have 3 of the following: 1 lower case character, 1 upper case character, 1 number, and 1 special character.

Virtual machine name must be between 1 and 15 characters long.

Virtual machine name cannot contain only numbers.

Virtual machine name Can't start with underscore. Can't end with period or hyphen

Virtual machine name cannot contain special characters \/""[]:|<>+=;,?*@&, .

Virtual machine name must be unique in the current resource group.

Username must be between 1 and 20 characters long.

Username cannot end with period

Username cannot contain special characters \/""[]:|<>+=;,?*@& .

Username must not include reserved words.

Password and confirm password must match.

Select a valid virtual machine size.

Enter name for new virtual network

Enter name for new subnet

Enter name for new public IP

Virtual Network name must be between 2 and 64 characters long

Create a new virtual network

Subnet name must be between 1 and 80 characters long

Create a new sub network

Public IP name must be between 1 and 80 characters long

Create a new new public Ip

Private (within Virtual Network)

Local (inside VM only)

Public (Internet)

Username must be between 2 and 128 characters long.

Username cannot contain special characters \/""[]:|<>+=;,?* .

Password and confirm password must match.

Review your configuration

Min Ip address is invalid

Max Ip address is invalid

Firewall name cannot contain only numbers.

Firewall name must be between 1 and 100 characters long.

Firewall name cannot contain special characters \/""[]:|<>+=;,?*@&, .

Upper case letters are not allowed for firewall name

Database name cannot contain only numbers.

Database name must be between 1 and 100 characters long.

Database name cannot contain special characters \/""[]:|<>+=;,?*@&, .

Database name must be unique in the current server.

Collation name cannot contain only numbers.

Collation name must be between 1 and 100 characters long.

Collation name cannot contain special characters \/""[]:|<>+=;,?*@&, .

No servers found

No servers found in current subscription. Select a different subscription containing at least one server

Deployment pre-requisites

Some tools were still not discovered. Please make sure that they are installed, running and discoverable

To proceed, you must accept the terms of the End User License Agreement(EULA)

Loading required tools information completed

Loading required tools information

Accept terms of use

'{0}' [ {1} ] does not meet the minimum version requirement, please uninstall it and restart Azure Data Studio.

All required tools are installed now.

Following tools: {0} were still not discovered. Please make sure that they are installed, running and discoverable

'{0}' was not discovered and automated installation is not currently supported. Install '{0}' manually or ensure it is started and discoverable. Once done please restart Azure Data Studio. See [{1}] .

You will need to restart Azure Data Studio if the tools are installed manually to pick up the change. You may find additional details in 'Deployments' and 'Azure Data CLI' output channels

Tool: {0} is not installed, you can click the "{1}" button to install it.

Tools: {0} are not installed, you can click the "{1}" button to install them.

No tools required

Download and launch installer, URL: {0}

Downloading from: {0}

Successfully downloaded: {0}

Launching: {0}

Successfully launched: {0}

Packages and runs applications in isolated containers

docker

Manages Azure resources

Azure CLI

deleting previously downloaded azurecli.msi if one exists …

downloading azurecli.msi and installing azure-cli …

displaying the installation log …

updating your brew repository for azure-cli installation …

installing azure-cli …

updating repository information before installing azure-cli …

getting packages needed for azure-cli installation …

downloading and installing the signing key for azure-cli …

adding the azure-cli repository information …

updating repository information again for azure-cli …

download and invoking script to install azure-cli …

Azure Data command line interface

Azure Data CLI

deleting previously downloaded Azdata.msi if one exists …

downloading Azdata.msi and installing azdata-cli …

displaying the installation log …

tapping into the brew repository for azdata-cli …

updating the brew repository for azdata-cli installation …

installing azdata …

updating repository information …

getting packages needed for azdata installation …

downloading and installing the signing key for azdata …

adding the azdata repository information …

Deployment options