azdata

Область применения: Azure Data CLI ()azdata

Замечание

Некоторые сценарии, которые ранее обрабатывались Azure Data CLI (azdata) теперь управляются с помощью расширений Azure CLI иazрабочих процессов на основе Azure Arc. Для всех azdata команд нет одной замены 1:1. В следующей таблице рассматриваются распространенные варианты Azure CLI, в которых они существуют.

azdata command area	Расширение Azure CLI или группа команд	Справочник по Azure CLI
azdata arc dc *	az arcdata	Справочник по интерфейсу командной строки данных Azure Arc
azdata arc sql mi *	az arcdata sql mi	Управление управляемым экземпляром SQL Azure с помощью CLI
azdata arc postgres *	az arcdata postgres	Управление сервером PostgreSQL с помощью CLI
azdata migrate *	az datamigration	Миграция с помощью интерфейса командной строки
azdata extension *	az extension *	Общие сведения о расширениях Azure CLI
azdata login	az login	az login
azdata sql shell / azdata sql query	Нет эквивалента Azure CLI (использование sqlcmd, SSMS или другие средства SQL)	служебная программа sqlcmd SQL Server Management Studio

Для новых сценариев автоматизации и управления предпочитайте azure CLI (az), расширения Azure CLI и портал Azure Arc.

В следующей статье приводятся справочные сведения по командам sql в средстве azdata. Дополнительные сведения о других командах azdata см. в справочнике по azdata.

Команды

Command	Описание
azdata arc	Команды для использования Azure Arc для служб данных Azure.
azdata sql	Интерфейс командной строки БАЗЫ данных SQL позволяет пользователю взаимодействовать с SQL Server с помощью T-SQL.
azdata login	Войдите в конечную точку контроллера кластера и задайте его пространство имен в качестве активного контекста. Чтобы использовать пароль для входа, необходимо задать переменную среды AZDATA_PASSWORD.
azdata logout	Выход из кластера.
azdata context	Команды управления контекстом.
azdata bdc	Выбор, управление кластерами больших данных SQL Server и управление ими.
azdata extension	Управление расширениями CLI и их обновление.
azdata app	Создание, удаление, запуск и управление приложениями.
azdata postgres	Средство выполнения запросов Postgres и интерактивная оболочка.
azdata notebook	Команды для просмотра, запуска и управления записными книжками из терминала.

azdata login

При развертывании кластера будет указана конечная точка контроллера во время развертывания, которую следует использовать для входа. Если вы не знаете конечную точку контроллера, вы можете войти, используя конфигурацию kube кластера в системе по умолчанию в расположении <пользователя home>/.kube/config или использовать kuBECONFIG env var, т. е. экспортировать KUBECONFIG=path/to/.kube/config. При входе в систему пространство имен этого кластера будет задано в активном контексте.

azdata login [--auth] 
             [--endpoint -e]  
             
[--accept-eula -a]  
             
[--namespace -ns]  
             
[--username -u]  
             
[--principal -p]

Примеры

Вход с помощью базовой проверки подлинности.

azdata login --auth basic --username johndoe --endpoint https://<ip or domain name>:30080

Вход с помощью Active Directory.

azdata login --auth ad --endpoint https://<ip or domain name>:30080                

Вход с помощью Active Directory с явным субъектом.

azdata login --auth ad --principal johndoe@COSTOSO.COM --endpoint https://<ip or domain name>:30080

Вход в интерактивном режиме. Имя кластера всегда будет запрашиваться, если не указано в качестве аргумента. Если в системе установлены AZDATA_USERNAME, AZDATA_PASSWORD и ACCEPT_EULA переменные env, они не будут запрашиваться. Если у вас есть конфигурация kube в системе или используется env var KUBECONFIG, чтобы указать путь к конфигурации, интерактивный интерфейс сначала попытается использовать конфигурацию, а затем предложит вам, если конфигурация завершается ошибкой.

azdata login

Войдите в систему (неинтерактивно). Войдите с именем кластера, именем пользователя контроллера, конечной точкой контроллера и приемкой EULA в качестве аргументов. Переменная среды AZDATA_PASSWORD должна быть задана. Если вы не хотите указывать конечную точку контроллера, укажите конфигурацию kube на компьютере в расположении <пользователя по умолчанию home>/.kube/config или используйте kuBECONFIG env var, т. е. экспорт KUBECONFIG=path/to/.kube/config.

azdata login --namespace ClusterName --username johndoe@contoso.com  --endpoint https://<ip or domain name>:30080 --accept-eula yes

Войдите с помощью конфигурации kube на компьютере и задайте для AZDATA_USERNAME, AZDATA_PASSWORD и ACCEPT_EULA.

azdata login -n ClusterName

Необязательные параметры

--auth

Стратегия проверки подлинности. Обычная проверка подлинности или проверка подлинности Active Directory. По умолчанию используется обычная проверка подлинности.

--endpoint -e

Конечная точка контроллера кластера "https://host:port". Если вы не хотите использовать этот arg, вы можете использовать конфигурацию kube на компьютере. Убедитесь, что конфигурация расположена по умолчанию в расположении <пользователя home>/.kube/config или используйте env var KUBECONFIG.

--accept-eula -a

Вы принимаете условия лицензионного соглашения? [да/нет]. Если вы не хотите использовать этот arg, можно задать для переменной среды ACCEPT_EULA значение "да". Условия лицензии для этого продукта можно просмотреть по https://aka.ms/eula-azdata-enадресу.

--namespace -ns

Пространство имен плоскости управления кластером.

--username -u

Пользователь учетной записи. Если вы не хотите использовать этот аргумент, можно задать переменную среды AZDATA_USERNAME.

--principal -p

Область Kerberos. В большинстве случаев область Kerberos — это доменное имя в буквах верхнего регистра.

Глобальные аргументы

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--output -o

Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json.

--query -q

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

azdata logout

Выход из кластера.

azdata logout 

Примеры

Выйдите из системы этого пользователя.

azdata logout

Глобальные аргументы

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--output -o

Формат вывода. Допустимые значения: json, jsonc, table, tsv. Значение по умолчанию: json.

--query -q

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Дальнейшие действия

Дополнительные сведения о других командах azdata см. в справочнике по azdata.

Дополнительные сведения об установке средства azdata см. в разделе Установка azdata.