Azure CLI を使用して Azure Time Series Insights Gen2 環境を作成する
Note
Time Series Insights サービスは、2024 年 7 月 7 日に廃止されます。 できるだけ早く既存の環境を代替ソリューションに移行することを検討してください。 サポートの終了と移行の詳細については、こちらのドキュメントを参照してください。
このドキュメントでは、新しい Time Series Insights Gen2 環境を作成する手順について説明します。
Azure Cloud Shell
Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。 ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。
Azure Cloud Shell を開始するには、以下のようにします。
| オプション | 例とリンク |
|---|---|
| コードまたはコマンド ブロックの右上隅にある [使ってみる] を選択します。 [使ってみる] を選択しても、コードまたはコマンドは Cloud Shell に自動的にはコピーされません。 | ![Azure Cloud Shell の [使ってみる] の例を示すスクリーンショット。](../includes/media/cloud-shell-try-it/hdi-azure-cli-try-it.png) |
| https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。 |  |
| Azure portal の右上にあるメニュー バーの [Cloud Shell] ボタンを選択します。 | ![Azure portal の [Cloud Shell] ボタンを示すスクリーンショット](../includes/media/cloud-shell-try-it/hdi-cloud-shell-menu.png) |
Azure Cloud Shell を使用するには、以下のようにします。
Cloud Shell を開始します。
コード ブロック (またはコマンド ブロック) の [コピー] ボタンを選択し、コードまたはコマンドをコピーします。
Windows と Linux では Ctrl+Shift+V キーを選択し、macOS では Cmd+Shift+V キーを選択して、コードまたはコマンドを Cloud Shell セッションに貼り付けます。
Enter キーを選択して、コードまたはコマンドを実行します。
前提条件
- 自分の環境のコールド ストア用 Azure ストレージ アカウントを作成する。 このアカウントは、履歴データの長期保有と分析を目的として設計されています。
Note
コード内の mytsicoldstore をコールド ストレージ アカウントの一意の名前に置き換えます。
まず、ストレージ アカウントを作成します。
storage=mytsicoldstore
rg=-my-resource-group-name
az storage account create -g $rg -n $storage --https-only
key=$(az storage account keys list -g $rg -n $storage --query [0].value --output tsv
環境を作成する
ストレージ アカウントが作成され、その名前と管理キーが変数に割り当てられたので、次のコマンドを実行して Azure Time Series Insights 環境を作成します。
Note
コード内で、次の項目を実際のシナリオの一意の名前に置き換えます。
my-tsi-envを環境名に置き換えます。my-ts-id-propを時系列 ID プロパティの名前に置き換えます。
重要
環境内の時系列 ID は、データベースのパーティション キーのようなものです。 時系列 ID は、時系列モデルの主キーとして機能します。
詳細については、「タイム シリーズ ID の選択に関するベスト プラクティス」を参照してください。
az tsi environment gen2 create --name "my-tsi-env" --location eastus2 --resource-group $rg --sku name="L1" capacity=1 --time-series-id-properties name=my-ts-id-prop type=String --warm-store-configuration data-retention=P7D --storage-configuration account-name=$storage management-key=$key
Azure Time Series Insights 環境を削除する
Azure CLI を使用すると、Time Series Insights 環境などの個々のリソースを削除したり、リソース グループとそのすべてのリソース (Time Series Insights 環境など) を削除したりできます。
Time Series Insights 環境を削除するには、次のコマンドを実行します。
az tsi environment delete --name "my-tsi-env" --resource-group $rg
ストレージ アカウントを削除するには、次のコマンドを実行します。
az storage account delete --name $storage --resource-group $rg
リソース グループとそのすべてのリソースを削除するには、次のコマンドを実行します。
az group delete --name $rg
次のステップ
- Azure Time Series Insights Gen2 環境のストリーミング インジェストのイベント ソースをご覧ください。
- IoT Hub に接続する方法をご覧ください。