Buat sumber daya Azure Time Series Insights Gen 1 menggunakan templat Azure Resource Manager
Catatan
Layanan Time Series Insights akan dihentikan pada 7 Juli 2024. Pertimbangkan untuk memigrasikan lingkungan yang ada ke solusi alternatif sesegera mungkin. Untuk informasi selengkapnya tentang penghentian dan migrasi, kunjungi dokumentasi kami.
Perhatian
Ini adalah artikel Gen1.
Artikel ini menjelaskan cara membuat dan menggunakan sumber daya Azure Time Series Insights menggunakan templat Azure Resource Manager, PowerShell, dan penyedia sumber daya Azure Time Series Insights.
Azure Time Series Insights mendukung sumber daya berikut:
| Sumber daya | Deskripsi |
|---|---|
| Lingkungan | Lingkungan Azure Time Series Insights adalah pengelompokan peristiwa logis yang dibaca dari broker kejadian, disimpan, dan disediakan untuk kueri. Untuk informasi selengkapnya, baca Rencanakan lingkungan Azure Time Series Insights Anda |
| Sumber Kejadian | Sumber kejadian adalah koneksi ke broker kejadian tempat Azure Time Series Insights membaca dan menyerap kejadian ke lingkungan. Sumber kejadian yang saat ini didukung adalah IoT Hub dan Event Hub. |
| Himpunan Data Referensi | Himpunan data referensi menyediakan metadata tentang kejadian di lingkungan. Metadata dalam himpunan data referensi akan digabungkan dengan kejadian selama ingress. Himpunan data referensi didefinisikan sebagai sumber daya oleh properti kunci kejadian mereka. Metadata aktual yang membentuk himpunan data referensi diunggah atau dimodifikasi melalui API bidang data. |
| Kebijakan akses | Kebijakan akses memberikan izin untuk menerbitkan kueri data, memanipulasi data referensi di lingkungan, dan berbagi kueri dan perspektif tersimpan yang terkait dengan lingkungan. Untuk informasi selengkapnya, baca Berikan akses data ke lingkungan Time Series Insights menggunakan portal Microsoft Azure |
Templat Resource Manager adalah file JSON yang menentukan infrastruktur dan konfigurasi sumber daya dalam grup sumber daya. Dokumen berikut menguraikan file templat secara lebih rinci:
- Penyebaran templat Azure Resource Manager
- Sebarkan sumber daya dengan templat Resource Manager dan Azure PowerShell
- Jenis sumber daya Microsoft.TimeSeriesInsights
Templat mulai cepat timeseriesinsights-environment-with-eventhub diterbitkan di GitHub. Templat ini membuat lingkungan Azure Time Series Insights, sumber kejadian anak yang dikonfigurasi untuk menggunakan peristiwa dari Event Hub, dan kebijakan akses yang memberikan akses ke data lingkungan. Jika Event Hub yang ada tidak ditentukan, satu akan dibuat dengan penyebaran.
Catatan
Sebaiknya Anda menggunakan modul Azure Az PowerShell untuk berinteraksi dengan Azure. Untuk memulai, lihat Menginstal Azure PowerShell. Untuk mempelajari cara bermigrasi ke modul Az PowerShell, lihat Memigrasikan Azure PowerShell dari AzureRM ke Az.
Tentukan templat dan parameter penyebaran
Prosedur berikut ini menjelaskan cara menggunakan PowerShell untuk menerapkan templat Azure Resource Manager yang membuat lingkungan Azure Time Series Insights, sumber kejadian anak yang dikonfigurasi untuk mengkonsumsi peristiwa dari Event Hub, dan kebijakan akses yang memberikan akses ke data lingkungan. Jika Event Hub yang ada tidak ditentukan, satu akan dibuat dengan penyebaran.
Pasang Azure PowerShell dengan mengikuti instruksi di Memulai menggunakan Azure PowerShell.
Klon atau salin templat timeseriesinsights-environment-with-eventhub dari GitHub.
Buat file parameter
Untuk membuat file parameter, salin file timeseriesinsights-environment-with-eventhub.
{ "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#", "contentVersion": "1.0.0.0", "parameters": { "eventHubNamespaceName": { "value": "GEN-UNIQUE" }, "eventHubName": { "value": "GEN-UNIQUE" }, "consumerGroupName": { "value": "GEN-UNIQUE" }, "environmentName": { "value": "GEN-UNIQUE" }, "eventSourceName": { "value": "GEN-UNIQUE" } } }
Parameter yang Diperlukan
Parameter Deskripsi eventHubNamespaceName Namespace hub kejadian sumber. eventHubName Nama hub kejadian sumber. consumerGroupName Nama grup konsumen yang akan digunakan layanan Azure Time Series Insights untuk membaca data dari hub kejadian. CATATAN: Untuk menghindari pertikaian sumber daya, grup konsumen ini harus didedikasikan untuk layanan Azure Time Series Insights dan tidak dibagikan dengan pembaca lain. environmentName Nama lingkungan. Nama tidak boleh menyertakan: <,>,%,&,:,\\,?,/, dan karakter kontrol apa pun. Semua karakter lainnya diperbolehkan.eventSourceName Nama sumber daya anak sumber kejadian. Nama tidak boleh menyertakan: <,>,%,&,:,\\,?,/, dan karakter kontrol apa pun. Semua karakter lainnya diperbolehkan.
Parameter Opsional
Parameter Deskripsi existingEventHubResourceId ID sumber daya opsional dari Event Hub yang akan terhubung ke lingkungan Azure Time Series Insights melalui sumber kejadian. CATATAN: Pengguna yang menyebarkan templat harus memiliki hak istimewa untuk melakukan operasi listkeys di Event Hub. Jika tidak ada nilai yang disampaikan, hub kejadian baru akan dibuat oleh templat. environmentDisplayName Nama ramah opsional untuk ditampilkan dalam alat atau antarmuka pengguna alih-alih nama lingkungan. environmentSkuName Nama sku. Untuk informasi selengkapnya, baca halaman Harga Azure Time Series Insights. environmentSkuCapacity Kapasitas unit Sku. Untuk informasi selengkapnya, baca halaman Harga Azure Time Series Insights. environmentDataRetentionTime Batas waktu minimum kejadian lingkungan akan tersedia untuk kueri. Nilai harus ditentukan dalam format ISO 8601, misalnya P30Duntuk kebijakan retensi 30 hari.eventSourceDisplayName Nama ramah opsional untuk ditampilkan dalam alat atau antarmuka pengguna alih-alih nama sumber kejadian. eventSourceTimestampPropertyName Properti acara yang akan digunakan sebagai tanda waktu sumber kejadian. Jika nilai tidak ditentukan untuk timestampPropertyName, atau jika string null atau kosong ditentukan, waktu pembuatan peristiwa akan digunakan. eventSourceKeyName Nama kunci akses bersama yang akan digunakan layanan Azure Time Series Insights untuk menyambungkan ke hub kejadian. accessPolicyReaderObjectIds Daftar ID objek pengguna atau aplikasi di ID Microsoft Entra yang seharusnya memiliki akses Pembaca ke lingkungan. ObjectId perwakilan layanan dapat diperoleh dengan memanggil cmdlet Get-AzADUser atau Get-AzADServicePrincipal. Membuat kebijakan akses untuk grup Microsoft Entra belum didukung. accessPolicyContributorObjectIds Daftar ID objek pengguna atau aplikasi di ID Microsoft Entra yang harus memiliki akses Kontributor ke lingkungan. ObjectId perwakilan layanan dapat diperoleh dengan memanggil cmdlet Get-AzADUser atau Get-AzADServicePrincipal. Membuat kebijakan akses untuk grup Microsoft Entra belum didukung. Sebagai contoh, file parameter berikut akan digunakan untuk membuat lingkungan dan sumber kejadian yang membaca kejadian dari hub kejadian yang ada. Ini juga menciptakan dua kebijakan akses yang memberikan akses Kontributor ke lingkungan.
{ "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#", "contentVersion": "1.0.0.0", "parameters": { "eventHubNamespaceName": { "value": "tsiTemplateTestNamespace" }, "eventHubName": { "value": "tsiTemplateTestEventHub" }, "consumerGroupName": { "value": "tsiTemplateTestConsumerGroup" }, "environmentName": { "value": "tsiTemplateTestEnvironment" }, "eventSourceName": { "value": "tsiTemplateTestEventSource" }, "existingEventHubResourceId": { "value": "/subscriptions/{yourSubscription}/resourceGroups/MyDemoRG/providers/Microsoft.EventHub/namespaces/tsiTemplateTestNamespace/eventhubs/tsiTemplateTestEventHub" }, "accessPolicyContributorObjectIds": { "value": [ "AGUID001-0000-0000-0000-000000000000", "AGUID002-0000-0000-0000-000000000000" ] } } }Untuk informasi selengkapnya, lihat artikel Parameter.
Sebarkan templat mulai cepat secara lokal menggunakan PowerShell
Penting
Operasi baris perintah yang ditampilkan di bawah ini menjelaskan modul Az PowerShell.
Di PowerShell, masuk ke akun Azure Anda.
Dari prompt PowerShell, jalankan perintah berikut ini:
Connect-AzAccountAnda diminta untuk masuk ke akun Azure Anda. Setelah masuk, jalankan perintah berikut ini untuk menampilkan langganan yang tersedia:
Get-AzSubscriptionPerintah ini mengembalikan daftar langganan Azure yang tersedia. Pilih langganan untuk sesi saat ini dengan menjalankan perintah berikut ini. Ganti
<YourSubscriptionId>dengan GUID untuk langganan Azure yang ingin Anda gunakan:Set-AzContext -SubscriptionID <YourSubscriptionId>
Buat grup sumber daya baru jika grup sumber daya tidak ada.
Jika Anda tidak memiliki grup sumber daya yang ada, buat grup sumber daya baru dengan perintah New-AzResourceGroup. Sediakan nama grup sumber daya dan lokasi yang ingin Anda gunakan. Contohnya:
New-AzResourceGroup -Name MyDemoRG -Location "West US"Jika berhasil, ringkasan grup sumber daya baru akan ditampilkan.
ResourceGroupName : MyDemoRG Location : westus ProvisioningState : Succeeded Tags : ResourceId : /subscriptions/<GUID>/resourceGroups/MyDemoRG
Uji penyebaran.
Validasi penyebaran Anda dengan menjalankan cmdlet
Test-AzResourceGroupDeployment. Saat menguji penyebaran, berikan parameter persis seperti yang Anda lakukan saat menjalankan penyebaran.Test-AzResourceGroupDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json
Membuat penyebaran
Untuk membuat penyebaran baru, jalankan cmdlet
New-AzResourceGroupDeployment, dan berikan parameter yang diperlukan saat diminta. Parameter termasuk nama untuk penyebaran Anda, nama grup sumber daya Anda, dan jalur atau URL ke file templat. Jika parameter Mode tidak ditentukan, nilai default Bertahap akan digunakan. Untuk informasi selengkapnya, lihat Penyebaran bertahap dan lengkap.Perintah berikut ini meminta Anda memasukkan tiga parameter di jendela PowerShell:
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.jsonUntuk menentukan file parameter sebagai gantinya, gunakan perintah berikut:
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.jsonAnda juga dapat menggunakan parameter sebaris saat menjalankan cmdlet penyebaran. Perintahnya adalah sebagai berikut:
New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -parameterName "parameterValue"Untuk menjalankan penyebaran lengkap, atur parameter Mode ke Selesai:
New-AzResourceGroupDeployment -Name MyDemoDeployment -Mode Complete -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json
Verifikasi penyebaran
Jika sumber daya berhasil digunakan, ringkasan penyebaran ditampilkan di jendela PowerShell:
DeploymentName : MyDemoDeployment ResourceGroupName : MyDemoRG ProvisioningState : Succeeded Timestamp : 10/11/2019 3:20:37 AM Mode : Incremental TemplateLink : Parameters : Name Type Value ================================== ========================= ========== eventHubNewOrExisting String new eventHubResourceGroup String MyDemoRG eventHubNamespaceName String tsiquickstartns eventHubName String tsiquickstarteh consumerGroupName String tsiquickstart environmentName String tsiquickstart environmentDisplayName String tsiquickstart environmentSkuName String S1 environmentSkuCapacity Int 1 environmentDataRetentionTime String P30D eventSourceName String tsiquickstart eventSourceDisplayName String tsiquickstart eventSourceTimestampPropertyName String eventSourceKeyName String manage accessPolicyReaderObjectIds Array [] accessPolicyContributorObjectIds Array [] location String westus Outputs : Name Type Value ================ ========================= ========== dataAccessFQDN String 11aa1aa1-a1aa-1a1a-a11a-aa111a111a11.env.timeseries.azure.com DeploymentDebugLogLevel :
Sebarkan templat mulai cepat melalui portal Microsoft Azure
- Halaman beranda templat mulai cepat di GitHub juga menyertakan tombol Sebarkan ke Azure. Mengekliknya membuka halaman Penyebaran Kustom di portal Microsoft Azure. Dari halaman ini, Anda dapat memasukkan atau memilih nilai untuk setiap parameter dari parameter yang diperlukan atau tabel parameter opsional. Setelah mengisi pengaturan, mengeklik tombol Beli akan memulai penyebaran templat.
Langkah berikutnya
- Untuk informasi tentang mengelola sumber daya Azure Time Series Insights secara terprogram menggunakan API REST, baca Manajemen Azure Time Series Insights.