다음을 통해 공유


az dt data-history connection create

참고 항목

이 참조는 Azure CLI(버전 2.46.0 이상)에 대한 azure-iot 확장의 일부입니다. az dt data-history connection create 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

Digital Twins 인스턴스와 지원되는 리소스 간에 데이터 기록 연결을 만듭니다.

명령

Name Description 형식 상태
az dt data-history connection create adx

Digital Twins 인스턴스와 Azure Data Explorer 데이터베이스 간에 데이터 기록 연결을 만듭니다. 미리 만든 Azure Data Explorer 및 Event Hub 리소스가 필요합니다.

내선 번호 GA

az dt data-history connection create adx

Digital Twins 인스턴스와 Azure Data Explorer 데이터베이스 간에 데이터 기록 연결을 만듭니다. 미리 만든 Azure Data Explorer 및 Event Hub 리소스가 필요합니다.

연결을 성공적으로 만드는 데 필요한 Digital Twins 인스턴스 또는 사용자 할당 ID에 대해 다음 역할 및 권한을 추가하라는 메시지가 표시됩니다.

  • Azure Data Explorer 데이터베이스 범위에 대한 '기여자' 역할
  • Azure Data Explorer 데이터베이스 범위에 대한 '데이터베이스 관리자' 권한
  • 이벤트 허브 범위에 대한 'Azure Event Hubs 데이터 소유자' 역할
az dt data-history connection create adx --adx-cluster-name
                                         --adx-database-name
                                         --cn
                                         --dt-name
                                         --eh
                                         --ehn
                                         [--adx-property-events-table]
                                         [--adx-record-removals {false, true}]
                                         [--adx-relationship-events-table]
                                         [--adx-resource-group]
                                         [--adx-subscription]
                                         [--adx-table-name]
                                         [--adx-twin-events-table]
                                         [--ehc]
                                         [--ehg]
                                         [--ehs]
                                         [--mi-user-assigned]
                                         [--no-wait]
                                         [--resource-group]
                                         [--yes]

예제

$Default Event Hub 소비자 그룹을 사용하여 대상 Digital Twins 인스턴스에 데이터 기록 연결을 추가합니다.

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}

$Default Event Hub 소비자 그룹과 디지털 트윈과 연결된 사용자 할당 ID를 사용하여 대상 Digital Twins 인스턴스에 데이터 기록 연결을 추가합니다.

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}

사용자 지정 Azure Data Explorer 테이블 이름 및 Event Hub 소비자 그룹을 사용하여 대상 Digital Twins 인스턴스에 데이터 기록 연결을 추가합니다.

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}

대상 인스턴스의 여러 리소스 그룹 및 구독에서 이벤트 허브 및 Azure Data Explorer 인스턴스와 통합되는 대상 Digital Twins 인스턴스에 데이터 기록 연결을 추가합니다.

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}

$Default Event Hub 소비자 그룹을 사용하여 대상 Digital Twins 인스턴스에 데이터 기록 연결을 추가하고 역할 할당 프롬프트를 건너뜁니다.

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}

$Default Event Hub 소비자 그룹을 사용하여 대상 Digital Twins 인스턴스에 데이터 기록 연결을 추가하고 레코드 속성 및 항목 제거를 사용하도록 설정합니다. 트윈 및 관계의 속성에 대한 업데이트를 저장하는 데 사용되는 테이블에 추가 열이 추가됩니다(기본값은 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

$Default Event Hub 소비자 그룹을 사용하여 대상 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} --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}

$Default Event Hub 소비자 그룹을 사용하여 대상 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} --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 클러스터의 이름입니다.

--adx-database-name --adxd

통합할 Azure Data Explorer 데이터베이스의 이름입니다.

--cn --conn-name

데이터 기록 연결의 이름입니다.

--dt-name --dtn -n

Digital Twins 인스턴스 이름입니다.

--eh --eventhub

통합할 EventHub의 이름입니다.

--ehn --eventhub-namespace

EventHub 네임스페이스 식별자입니다.

선택적 매개 변수

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

트윈 및 관계의 속성에 대한 업데이트를 저장하는 데 사용되는 Azure Data Explorer 테이블의 이름입니다.

기본값: AdtPropertyEvents
--adx-record-removals --adxrr

인덱싱된 값 또는 키 값(예: 맵 항목, 배열 요소 등)의 제거를 포함하여 쌍/관계 속성 및 항목 제거를 기록할지 여부를 지정합니다. 이 속성을 'true'로 설정하면 ADX의 속성 이벤트 테이블에 추가 열이 생성됩니다.

허용되는 값: false, true
기본값: False
--adx-relationship-events-table --adxret

관계 수명 주기 이벤트를 기록하는 데 사용되는 Azure Data Explorer 테이블의 이름입니다. 이 속성을 지정하지 않은 상태로 두면 테이블이 만들어지지 않습니다.

--adx-resource-group --adxg

Azure Data Explorer 리소스 그룹의 이름입니다. 제공되지 않으면 Digital Twin의 리소스 그룹을 사용합니다.

--adx-subscription --adxs

Azure Data Explorer가 있는 구독의 이름 또는 ID입니다. 제공되지 않으면 Digital Twin Instance가 포함된 구독을 사용합니다.

--adx-table-name --adxt
사용되지 않음

옵션 '--adx-table-name'은 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 대신 '--adx-property-events-table'을 사용합니다.

트윈 및 관계의 속성에 대한 업데이트를 저장하는 데 사용되는 Azure Data Explorer 테이블의 이름입니다.

기본값: AdtPropertyEvents
--adx-twin-events-table --adxtet

쌍 수명 주기 이벤트를 기록하는 데 사용되는 Azure Data Explorer 테이블의 이름입니다. 이 속성을 지정하지 않은 상태로 두면 테이블이 만들어지지 않습니다.

--ehc --eventhub-consumer-group

ADX가 EventHub에서 읽을 때 사용할 EventHub 소비자 그룹입니다.

기본값: $Default
--ehg --eventhub-resource-group

EventHub 리소스 그룹의 이름입니다. 제공되지 않으면 Digital Twin의 리소스 그룹을 사용합니다.

--ehs --eventhub-subscription

EventHub가 있는 구독의 이름 또는 ID입니다. 제공되지 않으면 Digital Twin Instance가 포함된 구독을 사용합니다.

--mi-user-assigned --user

데이터 기록 연결 인증에 사용자 할당 관리 ID를 사용합니다. ID 리소스 ID를 허용합니다. 제공되지 않으면 시스템 ID를 대신 사용합니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

기본값: False
--resource-group -g

Digital Twins 인스턴스 리소스 그룹입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--yes -y

필요한 역할을 할당할 때 확인을 요청하지 마세요.

기본값: False
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
기본값: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.