Bagikan melalui

az dt data-history connection create

  • Referensi

Catatan

Referensi ini adalah bagian dari ekstensi azure-iot untuk Azure CLI (versi 2.46.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah az dt data-history connection create . Pelajari lebih lanjut tentang ekstensi.

Membuat koneksi riwayat data antara instans Digital Twins dan sumber daya yang didukung.

Perintah

Nama Deskripsi Jenis Status
az dt data-history connection create adx

Membuat koneksi riwayat data antara instans Digital Twins dan database Azure Data Explorer. Memerlukan sumber daya Azure Data Explorer dan Event Hub yang telah dibuat sebelumnya.

 Ekstensi GA

az dt data-history connection create adx

Membuat koneksi riwayat data antara instans Digital Twins dan database Azure Data Explorer. Memerlukan sumber daya Azure Data Explorer dan Event Hub yang telah dibuat sebelumnya.

Akan meminta pengguna untuk menambahkan peran dan izin berikut pada instans Digital Twins atau Identitas yang Ditetapkan Pengguna yang diperlukan untuk berhasil membuat koneksi:

  • Peran 'Kontributor' untuk cakupan Database Azure Data Explorer
  • Izin 'Admin Database' untuk cakupan Database Azure Data Explorer
  • Peran 'Pemilik Data Azure Event Hubs' untuk cakupan Pusat Aktivitas.
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]

Contoh

Menambahkan koneksi riwayat data ke instans Digital Twins target dengan grup konsumen $Default Event Hub.

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}

Menambahkan koneksi riwayat data ke instans Digital Twins target menggunakan Identitas yang Ditetapkan Pengguna yang terkait dengan Digital twin dengan grup konsumen Azure Event Hub $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}

Menambahkan koneksi riwayat data ke instans Digital Twins target dengan nama tabel Azure Data Explorer kustom dan grup konsumen Azure Event Hub.

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}

Menambahkan koneksi riwayat data ke instans Digital Twins target yang terintegrasi dengan instans Event Hub dan Azure Data Explorer di grup sumber daya dan langganan yang berbeda dari instans target.

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}

Menambahkan koneksi riwayat data ke instans Digital Twins target dengan grup konsumen $Default Event Hub dan melewati perintah penetapan peran.

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}

Menambahkan koneksi riwayat data ke instans Digital Twins target dengan grup konsumen $Default Event Hub dan mengaktifkan properti rekaman dan penghapusan item. Kolom tambahan akan ditambahkan ke tabel yang digunakan untuk menyimpan pembaruan pada properti kembar dan hubungan (default ke 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

Menambahkan koneksi riwayat data ke instans Digital Twins target dengan grup konsumen $Default Event Hub dan membuat dua tabel tambahan di database Azure Data Explorer. Satu tabel akan untuk merekam peristiwa siklus hidup kembar dan yang lainnya untuk peristiwa siklus hidup hubungan.

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}

Menambahkan koneksi riwayat data ke instans Digital Twins target dengan grup konsumen $Default Event Hub, menggunakan nama tabel peristiwa properti kembar kustom, dan membuat dua tabel tambahan di database 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}

Parameter yang Diperlukan

--adx-cluster-name --adxc

Nama kluster Azure Data Explorer untuk diintegrasikan.

--adx-database-name --adxd

Nama database Azure Data Explorer untuk diintegrasikan.

--cn --conn-name

Nama koneksi riwayat data.

--dt-name --dtn -n

Nama instans Digital Twins.

--eh --eventhub

Nama EventHub yang akan diintegrasikan.

--ehn --eventhub-namespace

Pengidentifikasi Namespace EventHub.

Parameter Opsional

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

Nama tabel Azure Data Explorer yang digunakan untuk menyimpan pembaruan properti kembar dan hubungan.

nilai default: AdtPropertyEvents
--adx-record-removals --adxrr

Menentukan apakah akan merekam properti kembar/hubungan atau tidak dan penghapusan item, termasuk penghapusan nilai terindeks atau kunci (seperti entri peta, elemen array, dll.). Mengatur properti ini ke 'true' akan menghasilkan kolom tambahan dalam tabel peristiwa properti di ADX.

nilai yang diterima: false, true
nilai default: False
--adx-relationship-events-table --adxret

Nama tabel Azure Data Explorer yang digunakan untuk merekam peristiwa siklus hidup hubungan. Tabel tidak akan dibuat jika properti ini dibiarkan tidak ditentukan.

--adx-resource-group --adxg

Nama grup sumber daya Azure Data Explorer. Jika tidak disediakan, akan menggunakan grup sumber daya Digital Twin.

--adx-subscription --adxs

Nama atau id langganan tempat Azure Data Explorer berada. Jika tidak disediakan, akan menggunakan langganan yang berisi Instans Digital Twin.

--adx-table-name --adxt
Tidak digunakan lagi

Opsi '--adx-table-name' telah tidak digunakan lagi dan akan dihapus dalam rilis mendatang. Gunakan '--adx-property-events-table' sebagai gantinya.

Nama tabel Azure Data Explorer yang digunakan untuk menyimpan pembaruan properti kembar dan hubungan.

nilai default: AdtPropertyEvents
--adx-twin-events-table --adxtet

Nama tabel Azure Data Explorer yang digunakan untuk merekam peristiwa siklus hidup kembar. Tabel tidak akan dibuat jika properti ini dibiarkan tidak ditentukan.

--ehc --eventhub-consumer-group

Grup konsumen EventHub untuk digunakan saat ADX membaca dari EventHub.

nilai default: $Default
--ehg --eventhub-resource-group

Nama grup sumber daya EventHub. Jika tidak disediakan, akan menggunakan grup sumber daya Digital Twin.

--ehs --eventhub-subscription

Nama atau id langganan tempat EventHub berada. Jika tidak disediakan, akan menggunakan langganan yang berisi Instans Digital Twin.

--mi-user-assigned --user

Gunakan identitas terkelola yang ditetapkan pengguna untuk autentikasi koneksi riwayat data. Menerima id sumber daya identitas. Jika tidak disediakan, akan menggunakan identitas sistem sebagai gantinya.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai default: False
--resource-group -g

Grup sumber daya instans Digital Twins. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

--yes -y

Jangan meminta konfirmasi saat menetapkan peran yang diperlukan.

nilai default: False
Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.