az sql mi-arc

Note

Эта ссылка является частью расширения arcdata для Azure CLI (версия 2.3.1 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az sql mi-arc. Подробнее о расширениях.

Управление управляемыми экземплярами SQL с поддержкой Azure Arc.

Команды

Имя	Описание	Тип	Состояние
az sql mi-arc config	Команды конфигурации.	Extension	GA
az sql mi-arc config add	Добавляет значение для пути JSON в файле конфигурации.	Extension	GA
az sql mi-arc config init	Инициализировать файлы CRD и спецификации для управляемого экземпляра SQL.	Extension	GA
az sql mi-arc config patch	Исправление файла конфигурации на основе файла исправления JSON.	Extension	GA
az sql mi-arc config remove	Удаляет значение пути JSON в файле конфигурации.	Extension	GA
az sql mi-arc config replace	Заменяет значение пути JSON в файле конфигурации.	Extension	GA
az sql mi-arc create	Создание управляемого экземпляра SQL.	Extension	GA
az sql mi-arc delete	Удаление управляемого экземпляра SQL.	Extension	GA
az sql mi-arc endpoint	Просмотр конечных точек SQL и управление ими.	Extension	GA
az sql mi-arc endpoint list	Выводит список конечных точек SQL.	Extension	GA
az sql mi-arc get-mirroring-cert	Извлеките сертификат конечной точки зеркального отображения группы доступности из sql mi и сохраните его в файле.	Extension	GA
az sql mi-arc list	Перечисление управляемых экземпляров SQL.	Extension	GA
az sql mi-arc reprovision-replica	Повторное создание реплики в управляемом экземпляре SQL.	Extension	GA
az sql mi-arc show	Отображение сведений об управляемом экземпляре SQL.	Extension	GA
az sql mi-arc update	Обновите конфигурацию управляемого экземпляра SQL.	Extension	GA
az sql mi-arc upgrade	Обновление управляемого экземпляра SQL.	Extension	GA

az sql mi-arc create

Создание управляемого экземпляра SQL.

Чтобы задать пароль управляемого экземпляра SQL, задайте переменную среды AZDATA_PASSWORD.

az sql mi-arc create --name
                     [--acquire-policy-token]
                     [--ad-account-name]
                     [--ad-connector-name]
                     [--ad-encryption-types]
                     [--admin-login-secret]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--change-reference]
                     [--collation]
                     [--cores-limit]
                     [--cores-request]
                     [--custom-location]
                     [--dev]
                     [--k8s-namespace]
                     [--keytab-secret]
                     [--labels]
                     [--language]
                     [--license-type]
                     [--memory-limit]
                     [--memory-request]
                     [--no-external-endpoint]
                     [--no-wait]
                     [--orchestrator-replicas]
                     [--path]
                     [--primary-dns-name]
                     [--primary-port-number]
                     [--private-key-file]
                     [--readable-secondaries]
                     [--replicas {1, 2, 3}]
                     [--resource-group]
                     [--retention-days]
                     [--secondary-dns-name]
                     [--secondary-port-number]
                     [--service-annotations]
                     [--service-cert-secret]
                     [--service-labels]
                     [--service-type {LoadBalancer, NodePort}]
                     [--storage-annotations]
                     [--storage-class-backups]
                     [--storage-class-data]
                     [--storage-class-datalogs]
                     [--storage-class-logs]
                     [--storage-class-orchestrator-logs]
                     [--storage-labels]
                     [--sync-secondary-to-commit {-1, 0, 1, 2}]
                     [--tde-mode]
                     [--tde-protector-private-key-file]
                     [--tde-protector-public-key-file]
                     [--tde-protector-secret]
                     [--tier]
                     [--time-zone]
                     [--trace-flags]
                     [--use-k8s]
                     [--volume-size-backups]
                     [--volume-size-data]
                     [--volume-size-datalogs]
                     [--volume-size-logs]
                     [--volume-size-orchestrator-logs]

Примеры

Создайте управляемый экземпляр SQL с помощью API Kubernetes.

az sql mi-arc create -n sqlmi1 --k8s-namespace arc --use-k8s

Создайте управляемый экземпляр SQL с 3 репликами в сценарии высокого уровня доступности с помощью API Kubernetes.

az sql mi-arc create -n sqlmi2 --replicas 3 --k8s-namespace arc --use-k8s

Создайте управляемый экземпляр SQL с помощью Azure Resource Manager (ARM).

az sql mi-arc create --name sqlmi3 --resource-group rg-name --custom-location arc-cl

Создайте управляемый экземпляр SQL с Active Directory аутентификацией через API Kubernetes.

az sql mi-arc create --name contososqlmi --k8s-namespace arc --ad-connector-name arcadc --ad-account-name arcuser --keytab-secret arcuser-keytab-secret --primary-dns-name contososqlmi-primary.contoso.local --primary-port-number 8143 --use-k8s

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

--name -n

Имя управляемого экземпляра SQL.

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--ad-account-name

Имя учетной записи Active Directory для этого Управляемый экземпляр SQL с поддержкой Arc. Эта учетная запись должна быть создана до развертывания этого экземпляра.

--ad-connector-name

Имя соединителя Active Directory. Этот параметр указывает намерение развернуть с поддержкой AD.

--ad-encryption-types

Список поддерживаемых типов шифрования Active Directory с разделим запятыми. Должно быть подмножеством следующих значений: RC4, AES128, AES256.

--admin-login-secret

Имя секрета Kubernetes для создания узлов или размещения учетных данных учетной записи входа администратора пользователя.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--agent-enabled

Включите агент SQL Server для экземпляра. По умолчанию оно отключено. Допустимые значения : true или false.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--annotations

Разделенный запятыми список заметок управляемого экземпляра SQL.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--cert-private-key-file

Путь к файлу, содержащий закрытый ключ сертификата в формате PEM, который будет использоваться для SQL Server.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--cert-public-key-file

Путь к файлу с открытым ключом с форматированным сертификатом PEM, который будет использоваться для SQL Server.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--collation

Параметры сортировки SQL Server для экземпляра.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--cores-limit -c

Ограничение ядер управляемого экземпляра в виде целого числа.

--cores-request

Запрос ядер управляемого экземпляра в виде целого числа.

--custom-location

Пользовательское расположение для этого экземпляра.

Свойство	Значение
Группа параметров:	Azure Resource Manager – targeted Arguments

--dev

Если это указано, то он считается экземпляром разработки и не будет выставлен счет за него.

--k8s-namespace -k

Пространство имен, в котором развертывается управляемый экземпляр SQL. Если пространство имен не указано, будет использоваться пространство имен, определенное в kubeconfig.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--keytab-secret

Имя секрета Kubernetes, содержащего файл keytab для этого Управляемый экземпляр SQL с поддержкой Arc.

--labels

Разделенный запятыми список меток управляемого экземпляра SQL.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--language

Языковой стандарт SQL Server для любого поддерживаемого идентификатора языка (LCID) для экземпляра.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--license-type -l

Тип лицензии, применяемый для этого управляемого экземпляра, — BasePrice, LicenseIncluded, DisasterRecovery.Default — LicenseIncluded. Тип лицензии можно изменить..

--memory-limit -m

Ограничение емкости управляемого экземпляра в виде целочисленного числа, за которым следует gi (gigabytes). Пример: 4Gi.

--memory-request

Запрос емкости управляемого экземпляра в виде целочисленного числа, за которым следует Gi (gigabytes). Пример: 4Gi.

--no-external-endpoint

Если задано, внешняя служба не будет создана. В противном случае внешняя служба будет создана с помощью того же типа службы, что и контроллер данных.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

--orchestrator-replicas

Количество реплик оркестратора высокой доступности. Значение должно быть от 1 до 3.

--path

Путь к файлу azext_arcdata для json управляемого экземпляра SQL.

--primary-dns-name

Dns-имя основной службы, предоставляемое конечным пользователям для подключения к этой Управляемый экземпляр SQL с поддержкой Arc (например, sqlinstancename.contoso.com).

--primary-port-number

Номер порта, на котором предоставляется основная служба пользователям (например, 31433).

--private-key-file

Файл закрытого ключа, созданный openSSL для использования в качестве идентификатора экземпляра.

--readable-secondaries

Количество реплик, доступных для чтения. Применяется только к уровню "Критически важный для бизнеса". Значение должно быть от 0 до числа реплик минус 1.

--replicas

Этот параметр указывает количество Управляемый экземпляр SQL реплик, которые будут развернуты в кластере Kubernetes для обеспечения высокой доступности. По умолчанию используется 1 реплика общего назначения, 3 реплики для критически важных для бизнеса.

Свойство	Значение
Допустимые значения:	1, 2, 3

--resource-group -g

Группа ресурсов Azure с поддержкой Arc, в которую следует добавить Управляемый экземпляр SQL с поддержкой Arc.

Свойство	Значение
Группа параметров:	Azure Resource Manager – targeted Arguments

--retention-days

Период хранения резервных копий, указанный в днях. Допустимые значения — от 0 до 35. Значение по умолчанию — 7. Установка периода хранения на 0 отключит автоматические резервные копии для всех баз данных в управляемом экземпляре SQL, а все предыдущие резервные копии будут удалены.

--secondary-dns-name

Dns-имя вторичной службы, предоставляемое конечным пользователям для подключения к этой Управляемый экземпляр SQL с поддержкой Arc (например, sqlinstancename2.contoso.com).

--secondary-port-number

Номер порта, на котором предоставляется вторичная служба конечным пользователям (например, 31434).

--service-annotations

Разделенный запятыми список заметок для применения ко всем внешним службам.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--service-cert-secret

Имя секрета Kubernetes для создания узлов или размещения сертификата службы SQL.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--service-labels

Разделенный запятыми список меток для применения ко всем внешним службам.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--service-type

Тип основной службы.

Свойство	Значение
Допустимые значения:	LoadBalancer, NodePort

--storage-annotations

Разделенный запятыми список заметок, применяемых ко всем PVC.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--storage-class-backups

Класс хранилища с поддержкой ReadWriteMany (RWX) для резервного копирования (/var/opt/mssql/backups). Если значение не указано, будет использоваться класс хранилища по умолчанию.

--storage-class-data -d

Класс хранилища, используемый для файлов данных (.mdf, NDF). Если значение не задано, класс хранилища не будет указан, что приведет к использованию Kubernetes по умолчанию.

--storage-class-datalogs

Класс хранилища, используемый для журналов базы данных (.ldf). Если значение не задано, класс хранилища не будет указан, что приведет к использованию Kubernetes по умолчанию.

--storage-class-logs

Класс хранилища, используемый для журналов (/var/log). Если значение не задано, класс хранилища не будет указан, что приведет к использованию Kubernetes по умолчанию.

--storage-class-orchestrator-logs

Класс хранилища, используемый для журналов оркестратора (/var/log). Если значение не задано, класс хранилища не будет указан, что приведет к использованию Kubernetes по умолчанию.

--storage-labels

Разделенный запятыми список меток, применяемых ко всем PVC.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--sync-secondary-to-commit

Количество вторичных реплик, которые должны быть синхронизированы для фиксации. При задании этого значения значение -1 будет задано число необходимых синхронизированных вторичных файлов "(# реплик - 1) / 2", округленное вниз.

Свойство	Значение
Default value:	-1
Допустимые значения:	-1, 0, 1, 2

--tde-mode

Режим прозрачное шифрование данных (TDE) для этого Управляемый экземпляр SQL с поддержкой Arc. Допустимые значения: ServiceManaged, CustomerManaged или Disabled. Значение по умолчанию — "Отключено".

--tde-protector-private-key-file

Путь к файлу, содержащий закрытый ключ сертификата в формате PEM, который будет использоваться для TDE.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--tde-protector-public-key-file

Путь к файлу, содержаму открытый ключ сертификата в формате PEM, который будет использоваться для TDE.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--tde-protector-secret

Имя секрета Kubernetes, содержащего сертификат защиты TDE и закрытый ключ для этого Управляемый экземпляр SQL с поддержкой Arc. Можно указать только для режима TDE CustomerManaged.

--tier -t

Ценовая категория для экземпляра. Допустимые значения: BusinessCritical (bc for short) или GeneralPurpose (gp for short). Значение по умолчанию — GeneralPurpose.

--time-zone

Часовой пояс SQL Server для экземпляра.

--trace-flags

Разделенный запятыми список трассировок. По умолчанию флаги отсутствуют.

--use-k8s

Создайте управляемый экземпляр SQL с помощью локальных API Kubernetes.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--volume-size-backups

Размер тома хранилища, используемого для резервного копирования, в качестве положительного числа, за которым следует Ki (килобайты), Mi (мегабайты) или Gi (гигабайты).

--volume-size-data

Размер тома хранилища, который будет использоваться для данных в качестве положительного числа, за которым следует Ki (килобайты), Mi (мегабайты) или Gi (гигабайты).

--volume-size-datalogs

Размер тома хранилища, используемого для журналов данных, как положительное число, за которым следует Ki (килобайты), Mi (мегабайты) или Gi (gigabytes).

--volume-size-logs

Размер тома хранилища, который будет использоваться для журналов в качестве положительного числа, за которым следует Ki (килобайты), Mi (мегабайты) или Gi (gigabytes).

--volume-size-orchestrator-logs

Размер тома хранилища, который будет использоваться для журналов оркестратора в качестве положительного числа, за которым следует Ki (килобайт), Mi (мегабайты) или Gi (gigabytes).

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

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

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

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

Свойство	Значение
Default value:	False

az sql mi-arc delete

Удаление управляемого экземпляра SQL.

az sql mi-arc delete --name
                     [--acquire-policy-token]
                     [--change-reference]
                     [--k8s-namespace]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]

Примеры

Удалите управляемый экземпляр SQL с помощью API Kubernetes.

az sql mi-arc delete --name sqlmi1 --k8s-namespace arc --use-k8s

Удаление управляемого экземпляра SQL с помощью Azure Resource Manager (ARM).

az sql mi-arc delete --name sqlmi1 --resource-group rg-name

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

--name -n

Имя управляемого экземпляра SQL, который необходимо удалить.

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--k8s-namespace -k

Пространство имен, в котором развертывается управляемый экземпляр SQL. Если пространство имен не указано, будет использоваться пространство имен, определенное в kubeconfig.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

--resource-group -g

Группа ресурсов с поддержкой Arc Azure, в которой существует Управляемый экземпляр SQL с поддержкой Arc.

Свойство	Значение
Группа параметров:	Azure Resource Manager – targeted Arguments

--use-k8s

Используйте локальные API Kubernetes для выполнения этого действия.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

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

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

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

Свойство	Значение
Default value:	False

az sql mi-arc get-mirroring-cert

Извлеките сертификат конечной точки зеркального отображения группы доступности из sql mi и сохраните его в файле.

az sql mi-arc get-mirroring-cert --cert-file
                                 --name
                                 [--acquire-policy-token]
                                 [--change-reference]
                                 [--k8s-namespace]
                                 [--use-k8s]

Примеры

Получение сертификата конечной точки зеркального отображения группы доступности из sqlmi1 и хранение в fileName1

az sql mi-arc get-mirroring-cert -n sqlmi1 --cert-file fileName1

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

--cert-file

Локальное имя файла для хранения полученного сертификата в формате PEM.

--name -n

Имя управляемого экземпляра SQL.

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--k8s-namespace -k

Пространство имен, в котором развертывается управляемый экземпляр SQL. Если пространство имен не указано, будет использоваться пространство имен, определенное в kubeconfig.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--use-k8s

Используйте локальные API Kubernetes для выполнения этого действия.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

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

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

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

Свойство	Значение
Default value:	False

az sql mi-arc list

Перечисление управляемых экземпляров SQL.

az sql mi-arc list [--custom-location]
                   [--k8s-namespace]
                   [--resource-group]
                   [--use-k8s]

Примеры

Перечисление управляемых экземпляров SQL.

az sql mi-arc list --use-k8s

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--custom-location

Настраиваемое расположение, в котором развертываются управляемые экземпляры SQL с поддержкой Arc. Если это не указано, будут перечислены все экземпляры в группе ресурсов.

Свойство	Значение
Группа параметров:	Azure Resource Manager – targeted Arguments

--k8s-namespace -k

Пространство имен Kubernetes, содержащее управляемые экземпляры SQL с поддержкой Arc. Если пространство имен не указано, будет использоваться пространство имен, определенное в kubeconfig.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--resource-group -g

Группа ресурсов Azure с поддержкой Arc, содержащая управляемые экземпляры SQL с поддержкой Arc.

Свойство	Значение
Группа параметров:	Azure Resource Manager – targeted Arguments

--use-k8s

Используйте локальные API Kubernetes для выполнения этого действия.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

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

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

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

Свойство	Значение
Default value:	False

az sql mi-arc reprovision-replica

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

az sql mi-arc reprovision-replica --name
                                  [--acquire-policy-token]
                                  [--change-reference]
                                  [--k8s-namespace]
                                  [--no-wait]
                                  [--use-k8s]

Примеры

Ex 1 — реплика повторной подготовки 1 управляемого экземпляра SQL sqlmi1.

az sql mi-arc reprovision-replica -n sqlmi1-1 --use-k8s --k8s-namespace namespace

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

--name -n

Имя реплики управляемого экземпляра SQL для повторной подготовки.

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--k8s-namespace -k

Пространство имен, в котором развертывается реплика управляемого экземпляра SQL. Если пространство имен не указано, будет использоваться пространство имен, определенное в kubeconfig.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

--use-k8s

Повторная подготовка реплики управляемого экземпляра SQL с помощью локальных API Kubernetes.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

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

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

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

Свойство	Значение
Default value:	False

az sql mi-arc show

Отображение сведений об управляемом экземпляре SQL.

az sql mi-arc show --name
                   [--k8s-namespace]
                   [--path]
                   [--resource-group]
                   [--use-k8s]

Примеры

Отображение сведений о Управляемый экземпляр SQL с помощью API Kubernetes.

az sql mi-arc show --name sqlmi1 --k8s-namespace arc --use-k8s

Отображение сведений о Управляемый экземпляр SQL путем запроса Azure Resource Manager (ARM).

az sql mi-arc show --name sqlmi1 --resource-group rg-name

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

--name -n

Имя управляемого экземпляра SQL, отображаемого.

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--k8s-namespace -k

Пространство имен, в котором развертывается управляемый экземпляр SQL. Если пространство имен не указано, будет использоваться пространство имен, определенное в kubeconfig.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--path -p

Путь, в котором должна быть записана полная спецификация управляемого экземпляра SQL. Если опущено, спецификация будет записана в стандартные выходные данные.

--resource-group -g

Группа ресурсов с поддержкой Arc Azure, в которой существует Управляемый экземпляр SQL с поддержкой Arc.

Свойство	Значение
Группа параметров:	Azure Resource Manager – targeted Arguments

--use-k8s

Используйте локальные API Kubernetes для выполнения этого действия.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

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

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

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

Свойство	Значение
Default value:	False

az sql mi-arc update

Обновите конфигурацию управляемого экземпляра SQL.

az sql mi-arc update --name
                     [--acquire-policy-token]
                     [--ad-encryption-types]
                     [--agent-enabled]
                     [--annotations]
                     [--cert-private-key-file]
                     [--cert-public-key-file]
                     [--change-reference]
                     [--cores-limit]
                     [--cores-request]
                     [--k8s-namespace]
                     [--keytab-secret]
                     [--labels]
                     [--license-type]
                     [--memory-limit]
                     [--memory-request]
                     [--no-wait]
                     [--orchestrator-replicas]
                     [--path]
                     [--preferred-primary-replica]
                     [--readable-secondaries]
                     [--replicas {1, 2, 3}]
                     [--resource-group]
                     [--retention-days]
                     [--service-annotations]
                     [--service-cert-secret]
                     [--service-labels]
                     [--sync-secondary-to-commit {-1, 0, 1, 2}]
                     [--tde-mode]
                     [--tde-protector-private-key-file]
                     [--tde-protector-public-key-file]
                     [--tde-protector-secret]
                     [--tier]
                     [--time-zone]
                     [--trace-flags]
                     [--use-k8s]

Примеры

Обновите конфигурацию управляемого экземпляра SQL.

az sql mi-arc update --path ./spec.json -n sqlmi1 --use-k8s

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

--name -n

Имя управляемого экземпляра SQL, редактируемого. Имя, в котором развертывается экземпляр, нельзя изменить.

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--ad-encryption-types

Список поддерживаемых типов шифрования Active Directory с разделим запятыми. Должно быть подмножеством следующих значений: RC4, AES128, AES256.

--agent-enabled

Включите агент SQL Server для экземпляра. По умолчанию оно отключено.

--annotations

Разделенный запятыми список заметок управляемого экземпляра SQL.

--cert-private-key-file

Путь к файлу, содержащий закрытый ключ сертификата в формате PEM, который будет использоваться для SQL Server.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--cert-public-key-file

Путь к файлу с открытым ключом с форматированным сертификатом PEM, который будет использоваться для SQL Server.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--cores-limit -c

Ограничение ядер управляемого экземпляра в виде целого числа.

--cores-request

Запрос ядер управляемого экземпляра в виде целого числа.

--k8s-namespace -k

Пространство имен, в котором развертывается управляемый экземпляр SQL. Если пространство имен не указано, будет использоваться пространство имен, определенное в kubeconfig.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--keytab-secret

Имя секрета Kubernetes, содержащего файл keytab для этого Управляемый экземпляр SQL с поддержкой Arc.

--labels

Разделенный запятыми список меток управляемого экземпляра SQL.

--license-type -l

Тип лицензии, применяемый для этого управляемого экземпляра, — BasePrice, LicenseIncluded, DisasterRecovery.Default — LicenseIncluded. Тип лицензии можно изменить..

--memory-limit -m

Ограничение емкости управляемого экземпляра в виде целочисленного числа, за которым следует gi (gigabytes). Пример: 4Gi.

--memory-request

Запрос емкости управляемого экземпляра в виде целочисленного числа, за которым следует Gi (gigabytes). Пример: 4Gi.

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

--orchestrator-replicas

Количество реплик оркестратора высокой доступности. Значение должно быть от 1 до 3.

--path

Путь к файлу azext_arcdata для json управляемого экземпляра SQL.

--preferred-primary-replica

Предпочтительная первичная реплика для обновления.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--readable-secondaries

Количество реплик, доступных для чтения. Применяется только к уровню "Критически важный для бизнеса". Значение должно быть от 0 до числа реплик минус 1.

--replicas

Этот параметр указывает количество Управляемый экземпляр SQL реплик, которые будут развернуты в кластере Kubernetes для обеспечения высокой доступности.

Свойство	Значение
Допустимые значения:	1, 2, 3

--resource-group -g

Группа ресурсов с поддержкой Arc Azure, в которой существует Управляемый экземпляр SQL с поддержкой Arc.

Свойство	Значение
Группа параметров:	Azure Resource Manager – targeted Arguments

--retention-days

Период хранения резервных копий, указанный в днях. Допустимые значения — от 0 до 35. Значение по умолчанию — 7. Установка периода хранения на 0 отключит автоматические резервные копии для всех баз данных в управляемом экземпляре SQL, а все предыдущие резервные копии будут удалены.

--service-annotations

Разделенный запятыми список заметок для применения ко всем внешним службам.

--service-cert-secret

Имя секрета Kubernetes для создания узлов или размещения сертификата службы SQL.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--service-labels

Разделенный запятыми список меток для применения ко всем внешним службам.

--sync-secondary-to-commit

Количество вторичных реплик, которые должны быть синхронизированы для фиксации. При задании этого значения значение -1 будет задано число необходимых синхронизированных вторичных файлов "(# реплик - 1) / 2", округленное вниз.

Свойство	Значение
Допустимые значения:	-1, 0, 1, 2

--tde-mode

Режим прозрачное шифрование данных (TDE) для этого Управляемый экземпляр SQL с поддержкой Arc. Допустимые значения: ServiceManaged, CustomerManaged или Disabled. Значение по умолчанию — "Отключено".

--tde-protector-private-key-file

Путь к файлу, содержащий закрытый ключ сертификата в формате PEM, который будет использоваться для TDE.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--tde-protector-public-key-file

Путь к файлу, содержаму открытый ключ сертификата в формате PEM, который будет использоваться для TDE.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--tde-protector-secret

Имя секрета Kubernetes, содержащего сертификат защиты TDE и закрытый ключ для этого Управляемый экземпляр SQL с поддержкой Arc. Можно указать только для режима TDE CustomerManaged.

--tier -t

Ценовая категория для экземпляра. Допустимые значения: BusinessCritical (bc for short) или GeneralPurpose (gp for short). Значение по умолчанию — GeneralPurpose.

--time-zone

Часовой пояс SQL Server для экземпляра.

--trace-flags

Разделенный запятыми список трассировок. По умолчанию флаги отсутствуют.

--use-k8s

Используйте локальные API Kubernetes для выполнения этого действия.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

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

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

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

Свойство	Значение
Default value:	False

az sql mi-arc upgrade

Обновление управляемого экземпляра SQL.

Обновите управляемый экземпляр SQL до указанной требуемой версии. Если требуемая версия не указана, будет использоваться версия контроллера данных.

az sql mi-arc upgrade [--acquire-policy-token]
                      [--change-reference]
                      [--desired-version]
                      [--dry-run]
                      [--field-filter]
                      [--force]
                      [--k8s-namespace]
                      [--label-filter]
                      [--name]
                      [--no-wait]
                      [--resource-group]
                      [--target]
                      [--use-k8s]

Примеры

Обновление управляемого экземпляра SQL.

az sql mi-arc upgrade -n sqlmi1 -k arc --desired-version v1.1.0 --use-k8s

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство	Значение
Группа параметров:	Global Policy Arguments

--desired-version -v

Последняя допустимая версия для обновления до. Необязательно, если версия не указана, будет использоваться версия контроллера данных. Укажите "auto" для автоматического обновления до последней допустимой версии. Дополнительные сведения об автоматическом обновлении см. в следующем https://aka.ms/arc-sqlmi-auto-upgrade:

--dry-run -d

Указывает, какой экземпляр будет обновлен, но на самом деле не обновляет экземпляры.

--field-filter -f

Отфильтруйте, чтобы выбрать экземпляры для обновления на основе свойств ресурсов.

--force

Переопределяет все политики, которые могут применяться к экземпляру, и пытается выполнить обновление.

Свойство	Значение
Default value:	False

--k8s-namespace -k

Пространство имен, в котором развертывается управляемый экземпляр SQL. Если пространство имен не указано, будет использоваться пространство имен, определенное в kubeconfig.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

--label-filter -l

Фильтр для выбора экземпляра для обновления на основе меток.

--name -n

Имя управляемого экземпляра SQL.

--no-wait

Не ожидать завершения длительной операции.

Свойство	Значение
Default value:	False

--resource-group -g

Группа ресурсов Azure, в которой существует целевая Управляемый экземпляр SQL с поддержкой Arc.

Свойство	Значение
Группа параметров:	Azure Resource Manager – targeted Arguments

--target

Не рекомендуется

Параметр --target устарел и будет удален в будущем выпуске. Вместо этого используйте "--desired-version".

Последняя допустимая версия для обновления до. Необязательно, если версия не указана, будет использоваться версия контроллера данных. Укажите "auto" для автоматического обновления до последней допустимой версии. Дополнительные сведения об автоматическом обновлении см. в следующем https://aka.ms/arc-sqlmi-auto-upgrade:

--use-k8s

Используйте локальные API Kubernetes для выполнения этого действия.

Свойство	Значение
Группа параметров:	Kubernetes API – targeted Arguments

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

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

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство	Значение
Default value:	False

--output -o

Формат вывода.

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

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

Свойство	Значение
Default value:	False