Поделиться через

az dt data-history connection create

Note

Эта ссылка является частью расширения Azure-iot для Azure CLI (версия 2.67.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az dt data-history connection create. Подробнее о расширениях.

Создает подключение журнала данных между экземпляром Digital Twins и поддерживаемыми ресурсами.

Команды

Имя Описание Тип Состояние
az dt data-history connection create adx

Создает подключение журнала данных между экземпляром Digital Twins и базой данных Azure Data Explorer. Требует предварительно созданных ресурсов Azure Data Explorer и Концентратора событий.

 Extension GA

az dt data-history connection create adx

Создает подключение журнала данных между экземпляром Digital Twins и базой данных Azure Data Explorer. Требует предварительно созданных ресурсов Azure Data Explorer и Концентратора событий.

Будет предложено пользователю добавить следующие роли и разрешения на экземпляр Digital Twins или назначаемое пользователем удостоверение, необходимое для успешного создания подключения:

  • Роль участника для области базы данных Azure Data Explorer
  • Разрешение "Администратор базы данных" для области базы данных Azure Data Explorer
  • Роль владельца данных Центров событий Azure для области концентратора событий.
az dt data-history connection create adx --adx-cluster-name --adxc
                                         --adx-database-name --adxd
                                         --cn --conn-name
                                         --dt-name --dtn
                                         --eh --eventhub
                                         --ehn --eventhub-namespace
                                         [--adx-property-events-table --adxpet]
                                         [--adx-record-removals --adxrr {false, true}]
                                         [--adx-relationship-events-table --adxret]
                                         [--adx-resource-group --adxg]
                                         [--adx-subscription --adxs]
                                         [--adx-table-name --adxt]
                                         [--adx-twin-events-table --adxtet]
                                         [--ehc --eventhub-consumer-group]
                                         [--ehg --eventhub-resource-group]
                                         [--ehs --eventhub-subscription]
                                         [--mi-user-assigned --user]
                                         [--no-wait]
                                         [--resource-group]
                                         [--yes]

Примеры

Добавляет подключение журнала данных к целевому экземпляру Digital Twins с группой потребителей центра событий $Default.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace}

Добавляет подключение журнала данных к целевому экземпляру Digital Twins с помощью назначенного пользователем удостоверения, связанного с цифровым двойником с группой потребителей центра событий $Default.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --mi-user-assigned {resource_id}

Добавляет подключение журнала данных к целевому экземпляру Digital Twins с пользовательским именем таблицы Azure Data Explorer и группой потребителей Концентратора событий.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --adx-property-events-table {adx_property_events_table_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --eventhub-consumer-group {event_hub_consumer_group}

Добавляет подключение журнала данных к целевому экземпляру Digital Twins, интегрируемого с концентратором событий и экземплярами Azure Data Explorer в разных группах ресурсов и подписках из целевого экземпляра.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --adx-resource-group {adx_resource_group} --adx-subscription {adx_subscription} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --eventhub-resource-group {event_hub_resource_group} --eventhub-subscription {event_subscription}

Добавляет подключение журнала данных к целевому экземпляру Digital Twins с группой потребителей центра событий $Default и пропускает запросы на назначение ролей.

az dt data-history connection create adx -n {instance_name} -y --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace}

Добавляет подключение журнала данных к целевому экземпляру Digital Twins с группой потребителей центра событий $Default и включает удаление свойств записи и элементов. В таблицу будет добавлен дополнительный столбец, используемый для хранения обновлений свойств двойников и связей (по умолчанию — AdtPropertyEvents).

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --adx-record-removals true

Добавляет подключение журнала данных к целевому экземпляру Digital Twins с группой потребителей центра событий $Default и создает две дополнительные таблицы в базе данных Azure Data Explorer. Одна таблица будет использоваться для записи событий жизненного цикла двойника, а другая — для событий жизненного цикла отношений.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --adx-twin-events-table {adx_twin_events_table_name} --adx-relationship-events-table {adx_relationship_events_table_name}

Добавляет подключение журнала данных к целевому экземпляру Digital Twins с группой потребителей центра событий $Default, использует имя таблицы событий пользовательского свойства двойника и создает две дополнительные таблицы в базе данных Azure Data Explorer.

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --adx-property-events-table {adx_property_events_table_name} --adx-twin-events-table {adx_twin_events_table_name} --adx-relationship-events-table {adx_relationship_events_table_name}

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

--adx-cluster-name --adxc

Имя кластера Azure Data Explorer для интеграции.

Свойство Значение
Группа параметров: Azure Data Explorer Arguments
--adx-database-name --adxd

Имя базы данных Azure Data Explorer для интеграции.

Свойство Значение
Группа параметров: Azure Data Explorer Arguments
--cn --conn-name

Имя подключения журнала данных.

--dt-name --dtn -n

Имя экземпляра Digital Twins.

--eh --eventhub

Имя EventHub для интеграции с.

Свойство Значение
Группа параметров: Event Hub Arguments
--ehn --eventhub-namespace

Идентификатор пространства имен EventHub.

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

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

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

--adx-property-events-table --adxpet

Имя таблицы Azure Data Explorer, используемой для хранения обновлений свойств двойников и связей.

Свойство Значение
Группа параметров: Azure Data Explorer Arguments
Default value: AdtPropertyEvents
--adx-record-removals --adxrr

Указывает, следует ли записывать свойства двойника или свойства связи и удаления элементов, включая удаление индексированных или ключевых значений (например, записей карты, элементов массива и т. д.). Если для этого свойства задано значение true, будет создан дополнительный столбец в таблице событий свойств в ADX.

Свойство Значение
Группа параметров: Azure Data Explorer Arguments
Default value: False
Допустимые значения: false, true
--adx-relationship-events-table --adxret

Имя таблицы Azure Data Explorer, используемой для записи событий жизненного цикла отношений. Таблица не будет создана, если это свойство не указано.

Свойство Значение
Группа параметров: Azure Data Explorer Arguments
--adx-resource-group --adxg

Имя группы ресурсов Azure Data Explorer. Если это не указано, используйте группу ресурсов Digital Twin.

Свойство Значение
Группа параметров: Azure Data Explorer Arguments
--adx-subscription --adxs

Имя или идентификатор подписки, в которой существует Azure Data Explorer. Если это не указано, используйте подписку, содержащую экземпляр Digital Twin.

Свойство Значение
Группа параметров: Azure Data Explorer Arguments
--adx-table-name --adxt
Не рекомендуется

Параметр "-adx-table-name" устарел и будет удален в будущем выпуске. Вместо этого используйте "-adx-property-events-table".

Имя таблицы Azure Data Explorer, используемой для хранения обновлений свойств двойников и связей.

Свойство Значение
Группа параметров: Azure Data Explorer Arguments
Default value: AdtPropertyEvents
--adx-twin-events-table --adxtet

Имя таблицы Azure Data Explorer, используемой для записи событий жизненного цикла двойника. Таблица не будет создана, если это свойство не указано.

Свойство Значение
Группа параметров: Azure Data Explorer Arguments
--ehc --eventhub-consumer-group

Группа потребителей EventHub, используемая при чтении ADX из EventHub.

Свойство Значение
Группа параметров: Event Hub Arguments
Default value: $Default
--ehg --eventhub-resource-group

Имя группы ресурсов EventHub. Если это не указано, используйте группу ресурсов Digital Twin.

Свойство Значение
Группа параметров: Event Hub Arguments
--ehs --eventhub-subscription

Имя или идентификатор подписки, в которой существует EventHub. Если это не указано, используйте подписку, содержащую экземпляр Digital Twin.

Свойство Значение
Группа параметров: Event Hub Arguments
--mi-user-assigned --user

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

--no-wait

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

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

Группа ресурсов экземпляра Digital Twins. Группу по умолчанию можно настроить с помощью az configure --defaults group={name}.

--yes -y

Не запрашивайте подтверждение при назначении обязательных ролей.

Свойство Значение
Default value: False
Глобальные параметры
--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