方法: さまざまなデータソースを接続する

[アーティクル]
09/20/2024

重要

2023 年 9 月 20 日以降は、新しい Metrics Advisor リソースを作成できなくなります。 Metrics Advisor サービスは、2026 年 10 月 1 日に廃止されます。

重要

Microsoft では、使用可能な最も安全な認証フローを使用することをお勧めします。この記事で説明する認証フローの中には、アプリケーションに非常に高い信頼が必要なものもあります。また、他のより安全なフローには存在しないリスクが伴います。このフローは、マネージド ID など、より安全なフローが実行可能ではない場合にのみ使用してください。

この記事を使用して、さまざまな種類のデータソースを Azure AI Metrics Advisor に接続するための設定と要件を理解してください。 Metrics Advisor でデータを使用する方法の詳細については、データのオンボードに関するページを参照してください。

サポートされている認証の種類

認証の種類	説明
Basic	データソースにアクセスするための基本パラメーターを指定する必要があります。たとえば、接続文字列またはパスワードを使用できます。データフィード管理者は、これらの資格情報を表示できます。
Azure マネージド ID	Azure リソースのマネージド ID は、Microsoft Entra ID の機能です。これにより、Microsoft Entra ID で自動的に管理される ID が Azure サービスに提供されます。 ID を使用して、Microsoft Entra 認証をサポートする任意のサービスに対する認証を行うことができます。
Azure SQL 接続文字列	AzureSQL 接続文字列を資格情報エンティティとして Metrics Advisor に保存し、メトリックデータをインポートするたびにそれを直接使用します。これらの資格情報を表示できるのは資格情報エンティティの管理者だけですが、認可された閲覧者は、資格情報の詳細を知らなくてもデータフィードを作成できます。
Azure Data Lake Storage Gen2 共有キー	データレイクアカウントキーを資格情報エンティティとして Metrics Advisor に保存し、メトリックデータをインポートするたびにそれを直接使用します。これらの資格情報を表示できるのは資格情報エンティティの管理者だけですが、認可された閲覧者は、資格情報の詳細を知らなくてもデータフィードを作成できます。
サービスプリンシパル	サービスプリンシパルを資格情報エンティティとして Metrics Advisor に保存し、メトリックデータをインポートするたびにそれを直接使用します。資格情報を表示できるのは資格情報エンティティの管理者だけですが、認可された閲覧者は、資格情報の詳細を知らなくてもデータフィードを作成できます。
キーコンテナーからのサービスプリンシパル	キーコンテナーのサービスプリンシパルを資格情報エンティティとして Metrics Advisor に保存し、メトリックデータをインポートするたびにそれを直接使用します。これらの資格情報を表示できるのは資格情報エンティティの管理者だけですが、閲覧者は、資格情報の詳細を知らなくてもデータフィードを作成できます。

データソースおよび対応する認証の種類

データソース	認証の種類
Application Insights	基本
Azure Blob Storage (JSON)	基本マネージド ID
Azure Cosmos DB (SQL)	基本
Azure Data Explorer (Kusto)	基本マネージド ID サービスプリンシパルキーコンテナーからのサービスプリンシパル
Azure Data Lake Storage Gen2	基本 Data Lake Storage Gen2 共有キーサービスプリンシパルキーコンテナーからのサービスプリンシパル
Azure Event Hubs	基本
Azure Monitor ログ	基本サービスプリンシパルキーコンテナーからのサービスプリンシパル
Azure SQL Database / SQL Server	基本マネージド ID サービスプリンシパルキーコンテナーからのサービスプリンシパル Azure SQL 接続文字列
Azure Table Storage	基本
InfluxDB (InfluxQL)	基本
MongoDB	基本
MySQL	基本
PostgreSQL	基本

次のセクションでは、さまざまなデータソースのシナリオ内のすべての認証の種類に必要なパラメーターを指定します。

Application Insights

Application ID: Application Insights API を使用している場合、このアプリケーションの識別に使用されます。 applicationId を取得するには、次の手順に従います。
1. Application Insights リソースから、 [API アクセス] を選択します。
2. Metrics Advisor の [アプリケーション ID] フィールドに生成されたアプリケーション ID をコピーします。
API キー: API キーは、このリソースにアクセスするために、ブラウザーの外側のアプリケーションによって使用されます。 API キーを取得するには、次の手順に従います。
1. Application Insights リソースから、 [API アクセス] を選択します。
2. [API キーの作成] を選択します。
3. 簡単な説明を入力し、 [テレメトリを読み取る] オプションを選択して、 [キーの生成] を選択します。
  
  重要
  
  この API キーをコピーして保存します。これは再表示されません。このキーを紛失した場合は、新しいキーを作成する必要があります。
4. API キーを Metrics Advisor の [API キー] フィールドにコピーします。
クエリ: Azure Application Insights ログは、Azure Data Explorer 上に構築されており、Azure Monitor ログクエリでは、同じ Kusto クエリ言語のバージョンが使用されます。 Kusto クエリ言語のドキュメントは、Application Insights に対するクエリを記述するためのプライマリリソースとなります。

サンプルクエリ:
```
[TableName] | where [TimestampColumn] >= datetime(@IntervalStart) and [TimestampColumn] < datetime(@IntervalEnd);
```
具体的な例については、有効なクエリの作成に関するチュートリアルに関するページ参照してください。

Azure Blob Storage (JSON)

接続文字列: Azure Blob Storage (JSON) には、次の 2 つの認証の種類があります。
- 基本: この文字列の取得の詳細については、Azure Storage の接続文字列の構成に関するページを参照してください。また、Azure Blob Storage リソースの Azure portal にアクセスし、 [設定]>[アクセスキー] で接続文字列を直接検索できます。
- マネージド ID: Azure リソースに対するマネージド ID では、BLOB およびキューデータへのアクセスを認可できます。この機能では、Azure 仮想マシン (VM)、関数アプリ、仮想マシンスケールセット、その他のサービスで動作するアプリケーションから、Microsoft Entra 資格情報を使用します。
  
  マネージド ID は、Azure Blob Storage リソースの Azure portal で作成できます。 [アクセス制御 (IAM)] で、 [ロールの割り当て] を選択してから、 [追加] を選択します。推奨されるロールの種類は、Storage Blob データ閲覧者です。詳細については、マネージド ID を使用した Azure Storage へのアクセスに関するページを参照してください。
コンテナー: Metrics Advisor では、1 つのコンテナーの下に BLOB ファイルとして格納する時系列データ (タイムスタンプごとに 1 つの BLOB) が想定されています。これはコンテナー名フィールドです。
BLOB テンプレート: Metrics Advisor では、パスを使用して、Blob Storage で JSON ファイルを検索します。これは、Blob Storage: %Y/%m/FileName_%Y-%m-%d-%h-%M.json で JSON ファイルを検索するために使用される BLOB ファイルテンプレートの例です。 %Y/%m はパスです。パスに %d がある場合は、%m の後に追加できます。 JSON ファイルの名前に日付が付けられている場合は、%Y-%m-%d-%h-%M.json を使用することもできます。

サポートされているパラメーターは次のとおりです。
- %Y は yyyy として書式設定された年です。
- %m は MM として書式設定された月です。
- %d は dd として書式設定された日です。
- %h は HH として書式設定された時間です。
- %M は mm として書式設定された分です。
たとえば、次のデータセットでは、BLOB テンプレートは %Y/%m/%d/00/JsonFormatV2.json になります。
JSON 形式のバージョン:JSON ファイルのデータスキーマを定義します。 Metrics Advisor では、次のバージョンをサポートしています。次のいずれかを選択して、フィールドに入力できます。
- v1
  
  メトリック Name と Value のみが受け入れられます。次に例を示します。
```
{"count":11, "revenue":1.23}
```
- v2
  
  メトリック Dimensions と timestamp も受け入れられます。次に例を示します。
```
[
  {"date": "2018-01-01T00:00:00Z", "market":"en-us", "count":11, "revenue":1.23},
  {"date": "2018-01-01T00:00:00Z", "market":"zh-cn", "count":22, "revenue":4.56}
]
```
JSON ファイルごとに 1 つのタイムスタンプのみが許可されます。

Azure Cosmos DB (SQL)

接続文字列: Azure Cosmos DB インスタンスにアクセスするための接続文字列。これは、Azure portal の Azure Cosmos DB リソースの [キー] にあります。詳細については、「Azure Cosmos DB のデータへのアクセスをセキュリティで保護する」を参照してください。
データベース:クエリ対象のデータベース。 Azure portal の [コンテナー] で、 [参照] に移動し、データベースを検索します。
コレクション ID:クエリ対象のコレクション ID。 Azure portal の [コンテナー] で、 [参照] に移動し、コレクション ID を検索します。
SQL クエリ: データを取得して多次元時系列データに編成する SQL クエリ。クエリでは、変数 @IntervalStart と @IntervalEnd を使用できます。これらは yyyy-MM-ddTHH:mm:ssZ のように書式設定する必要があります。

サンプルクエリ:
```
SELECT [TimestampColumn], [DimensionColumn], [MetricColumn] FROM [TableName] WHERE [TimestampColumn] >= @IntervalStart and [TimestampColumn] < @IntervalEnd    
```
詳細については、有効なクエリの作成に関するチュートリアルに関するページを参照してください。

Azure Data Explorer (Kusto)

接続文字列: Azure Data Explorer (Kusto) には、基本、サービスプリンシパル、キーコンテナーからのサービスプリンシパル、マネージド ID の 4 種類の認証があります。接続文字列のデータソースは、URI 形式 ("https" で始まる) である必要があります。 URI は Azure portal で確認できます。
- Basic: Metrics Advisor では、Microsoft Entra アプリケーション認証を使用して Azure Data Explorer (Kusto) へのアクセスをサポートします。 Microsoft Entra アプリケーションを作成して登録し、Azure Data Explorer データベースへのアクセスを認可する必要があります。詳細については、Azure Data Explorer での Microsoft Entra アプリの登録の作成に関する記事を参照してください。接続文字列の例を次に示します。
```
Data Source=<URI Server>;Initial Catalog=<Database>;AAD Federated Security=True;Application Client ID=<Application Client ID>;Application Key=<Application Key>;Authority ID=<Tenant ID>
```
- サービスプリンシパル: サービスプリンシパルは、アプリケーションオブジェクトから作成された具象インスタンスです。サービスプリンシパルは、そのアプリケーションオブジェクトから特定のプロパティを継承します。サービスプリンシパルオブジェクトには、特定のテナント内でアプリが実際に実行できること、アプリにアクセスできるユーザー、アプリからアクセスできるリソースを定義します。 Metrics Advisor でサービスプリンシパルを使用するには、次のようにします。
  1. Microsoft Entra アプリケーションの登録を作成します。詳細については、Azure Data Explorer での Microsoft Entra アプリの登録の作成に関する記事を参照してください。
  2. Azure Data Explorer のデータベースアクセス許可を管理します。詳細については、「Azure Data Explorer のデータベースアクセス許可を管理する」を参照してください。
  3. Metrics Advisor で資格情報エンティティを作成します。 Metrics Advisor で資格情報エンティティを作成する方法を参照します。これにより、サービスプリンシパルの認証の種類のデータフィードを追加する場合に、そのエンティティを選択できます。
  接続文字列の例を次に示します。
```
Data Source=<URI Server>;Initial Catalog=<Database>
```
- キーコンテナーからのサービスプリンシパル: Azure Key Vault では、クラウドアプリとサービスで使用される暗号化キーとシークレット値を保護するのに役立ちます。 Key Vault を使用すると、キーとシークレットの値を暗号化できます。まず、サービスプリンシパルを作成してから、Key Vault 内にサービスプリンシパルを格納する必要があります。詳細については、キーコンテナーからのサービスプリンシパルの資格情報エンティティの作成に関するページを参照し、詳細な手順に従って、キーコンテナーからのサービスプリンシパルを設定します。接続文字列の例を次に示します。
```
Data Source=<URI Server>;Initial Catalog=<Database>
```
- マネージド ID: Azure リソースに対するマネージド ID では、BLOB およびキューデータへのアクセスを認可できます。マネージド ID では、Azure 仮想マシン、関数アプリ、仮想マシンスケールセット、その他のサービスで動作するアプリケーションから、Microsoft Entra 資格情報を使用します。 Azure リソースのマネージド ID と Microsoft Entra 認証を使用すると、クラウドで動作するアプリケーションに資格情報を保存することを避けることができます。マネージド ID で認可する方法を参照してください。
  
  マネージド ID は、Azure Data Explorer (Kusto) の Azure portal で作成できます。 [アクセス許可]>[追加] の順に選択します。推奨されるロールの種類は、admin/viewer です。
  
  接続文字列の例を次に示します。
```
Data Source=<URI Server>;Initial Catalog=<Database>
```
クエリ: データを取得して多次元時系列データに編成するには、Kusto クエリ言語に関するページを参照してください。クエリでは、変数 @IntervalStart と @IntervalEnd を使用できます。これらは yyyy-MM-ddTHH:mm:ssZ のように書式設定する必要があります。

サンプルクエリ:
```
[TableName] | where [TimestampColumn] >= datetime(@IntervalStart) and [TimestampColumn] < datetime(@IntervalEnd);    
```
詳細については、有効なクエリの作成に関するチュートリアルに関するページを参照してください。

Azure Data Lake Storage Gen2

アカウント名: Azure Data Lake Storage Gen2 の認証の種類は、基本、Azure Data Lake Storage Gen2 共有キー、サービスプリンシパル、キーコンテナーからのサービスプリンシパルです。
- 基本: Azure Data Lake Storage Gen2 のアカウント名。これは、Azure Storage アカウント (Azure Data Lake Storage Gen2) リソースの [アクセスキー] にあります。
- Azure Data Lake Storage Gen2 共有キー: 最初に、Azure Data Lake Storage Gen2 にアクセスするためのアカウントキーを指定します (これは、基本認証の種類のアカウントキーと同じです)。これは、Azure Storage アカウント (Azure Data Lake Storage Gen2) リソースの [アクセスキー] にあります。次に、Azure Data Lake Storage Gen2 共有キーの種類の資格情報エンティティを作成し、アカウントキーを入力します。
  
  アカウント名は、基本認証の種類と同じです。
- サービスプリンシパル: サービスプリンシパルは、アプリケーションオブジェクトから作成された具象インスタンスであり、そのアプリケーションオブジェクトから特定のプロパティが継承されます。サービスプリンシパルは、アプリケーションが使用される各テナントで作成され、グローバルに一意なアプリオブジェクトが参照されます。サービスプリンシパルオブジェクトには、特定のテナント内でアプリが実際に実行できること、アプリにアクセスできるユーザー、アプリからアクセスできるリソースを定義します。
  
  アカウント名は、基本認証の種類と同じです。
  
  手順 1: Microsoft Entra アプリケーションを作成して登録し、データベースへのアクセスを認可します。詳細については、「Microsoft Entra アプリの登録を作成する」を参照してください。
  
  手順 2: ロールを割り当てます。
  1. Azure portal で、 [ストレージアカウント] サービスに移動します。
  2. このアプリケーションの登録に使用する Azure Data Lake Storage Gen2 アカウントを選択します。
  3. [アクセス制御 (IAM)] を選択します。
  4. [+ 追加] を選択し、メニューから [ロールの割り当ての追加] を選択します。
  5. [選択] フィールドを Microsoft Entra アプリケーション名に設定し、ロールを [ストレージ BLOB データ共同作成者] に設定します。その後、 [保存] を選びます。
  手順 3: Metrics Advisor で資格情報エンティティを作成する方法を参照します。これにより、サービスプリンシパルの認証の種類のデータフィードを追加する場合に、そのエンティティを選択できます。
- キーコンテナーからのサービスプリンシパル: Key Vault では、クラウドアプリとサービスで使用される暗号化キーとシークレット値を保護するのに役立ちます。 Key Vault を使用すると、キーとシークレットの値を暗号化できます。まず、サービスプリンシパルを作成してから、キーコンテナー内にサービスプリンシパルを格納する必要があります。詳細については、キーコンテナーからのサービスプリンシパルの資格情報エンティティの作成に関するページを参照してください。アカウント名は、基本認証の種類と同じです。
アカウントキー (基本認証の種類にのみ必要): Azure Data Lake Storage Gen2 にアクセスするためのアカウントキーを指定します。これは、Azure Storage アカウント (Azure Data Lake Storage Gen2) リソースの [アクセスキー] にあります。
ファイルシステム名 (コンテナー) :Metrics Advisor では、1 つのコンテナーの下に BLOB ファイルとして格納された時系列データ (タイムスタンプごとに 1 つの BLOB) を格納します。これはコンテナー名フィールドです。これは、Azure Storage アカウント (Azure Data Lake Storage Gen2) リソースインスタンスにあります。 [Data Lake Storage] で、 [コンテナー] を選択すると、コンテナー名が表示されます。
ディレクトリテンプレート: これは BLOB ファイルのディレクトリテンプレートです。サポートされているパラメーターは次のとおりです。
- %Y は yyyy として書式設定された年です。
- %m は MM として書式設定された月です。
- %d は dd として書式設定された日です。
- %h は HH として書式設定された時間です。
- %M は mm として書式設定された分です。
日次メトリックのクエリサンプル: %Y/%m/%d。

時間単位メトリックのクエリサンプル: %Y/%m/%d/%h。
ファイルテンプレート: Metrics Advisor では、パスを使用して、Blob Storage で JSON ファイルを検索します。以下は、Blob Storage: %Y/%m/FileName_%Y-%m-%d-%h-%M.json で JSON ファイルを検索するために使用される BLOB ファイルテンプレートの例です。 %Y/%m はパスです。パスに %d がある場合は、%m の後に追加できます。

サポートされているパラメーターは次のとおりです。
- %Y は yyyy として書式設定された年です。
- %m は MM として書式設定された月です。
- %d は dd として書式設定された日です。
- %h は HH として書式設定された時間です。
- %M は mm として書式設定された分です。
Metrics Advisor では、次の例のように JSON ファイルのデータスキーマがサポートされています。
```
[
   {"date": "2018-01-01T00:00:00Z", "market":"en-us", "count":11, "revenue":1.23},
   {"date": "2018-01-01T00:00:00Z", "market":"zh-cn", "count":22, "revenue":4.56}
]
```

Azure Event Hubs

制限事項: 統合に関する次の制限事項に注意してください。
- Metrics Advisor と Event Hubs の統合では、現在、パブリックプレビューの 1 つの Metrics Advisor インスタンスで 3 つを超えるアクティブなデータフィードがサポートされていません。
- Metrics Advisor では、一時停止したデータフィードを再アクティブ化する場合など、常に最新のオフセットからのメッセージの使用を開始します。
  - データフィードの一時停止中のメッセージは失われます。
  - データフィードの取り込みの開始時刻は、データフィードの作成時に、協定世界時の現在のタイムスタンプに自動的に設定されます。この時刻は参照のみを目的としています。
- コンシューマーグループごとに使用できるデータフィードは 1 つだけです。削除された別のデータフィードからコンシューマーグループを再利用するには、削除してから 10 分以上待つ必要があります。
- データフィードの作成後に、接続文字列とコンシューマーグループを変更することはできません。
- Event Hubs メッセージの場合は、JSON のみがサポートされており、JSON 値を入れ子になった JSON オブジェクトにすることはできません。最上位レベルの要素には、JSON オブジェクトまたは JSON 配列を指定できます。
  
  有効なメッセージは、次のとおりです。
  
  単一の JSON オブジェクト:
```
{
"metric_1": 234, 
"metric_2": 344, 
"dimension_1": "name_1", 
"dimension_2": "name_2"
}
```
  JSON 配列:
```
[
    {
        "timestamp": "2020-12-12T12:00:00", "temperature": 12.4,
        "location": "outdoor"
    },
    {
        "timestamp": "2020-12-12T12:00:00", "temperature": 24.8,
        "location": "indoor"
    }
]
```
接続文字列: Event Hubs のインスタンスに移動します。次に、新しいポリシーを追加するか、既存の共有アクセスポリシーを選択します。ポップアップパネルで接続文字列をコピーします。

接続文字列の例を次に示します。
```
Endpoint=<Server>;SharedAccessKeyName=<SharedAccessKeyName>;SharedAccessKey=<SharedAccess Key>;EntityPath=<EntityPath>
```
コンシューマーグループ: コンシューマーグループは、イベントハブ全体のビュー (状態、位置、またはオフセット) を表します。これは、Azure Event Hubs のインスタンスの [コンシューマーグループ] メニューで確認できます。コンシューマーグループでは、1 つのデータフィードに対してのみサービスを提供できます。データフィードごとに新しいコンシューマーグループを作成します。
タイムスタンプ (省略可能): Metrics Advisor では、ユーザーデータソースにタイムスタンプフィールドが含まれていない場合、イベントのタイムスタンプとして Event Hubs タイムスタンプを使用します。タイムスタンプフィールドは省略可能です。タイムスタンプ列が選択されていない場合、サービスでは、タイムスタンプとしてエンキューされた時刻を使用します。

タイムスタンプフィールドは、次の 2 つの形式のいずれかと一致する必要があります。
- YYYY-MM-DDTHH:MM:SSZ
- 1970-01-01T00:00:00Z のエポックからの秒またはミリ秒数。
タイムスタンプは、細分性に合わせて左揃えになります。たとえば、タイムスタンプが 2019-01-01T00:03:00Z の場合、細分性は 5 分になり、Metrics Advisor によって、タイムスタンプが 2019-01-01T00:00:00Z に揃えられます。イベントのタイムスタンプが 2019-01-01T00:10:00Z の場合、Metrics Advisor では、配置なしでタイムスタンプを直接使用します。

Azure Monitor ログ

Azure Monitor ログには、基本、サービスプリンシパル、キーコンテナーからのサービスプリンシパルの認証の種類があります。

基本: [テナント ID] 、 [クライアント ID] 、 [クライアントシークレット] 、 [ワークスペース ID] に入力する必要があります。 テナント ID、クライアント ID、クライアントシークレットを取得するには、アプリまたは Web API の登録に関するページを参照してください。 ワークスペース ID は、Azure portal で確認できます。
サービスプリンシパル: サービスプリンシパルは、アプリケーションオブジェクトから作成された具象インスタンスであり、そのアプリケーションオブジェクトから特定のプロパティが継承されます。サービスプリンシパルは、アプリケーションが使用される各テナントで作成され、グローバルに一意なアプリオブジェクトが参照されます。サービスプリンシパルオブジェクトには、特定のテナント内でアプリが実際に実行できること、アプリにアクセスできるユーザー、アプリからアクセスできるリソースを定義します。

手順 1: Microsoft Entra アプリケーションを作成して登録し、データベースへのアクセスを認可します。詳細については、「Microsoft Entra アプリの登録を作成する」を参照してください。

手順 2: ロールを割り当てます。
1. Azure portal で、 [ストレージアカウント] サービスに移動します。
2. [アクセス制御 (IAM)] を選択します。
3. [+ 追加] を選択し、メニューから [ロールの割り当ての追加] を選択します。
4. [選択] フィールドを Microsoft Entra アプリケーション名に設定し、ロールを [ストレージ BLOB データ共同作成者] に設定します。その後、 [保存] を選びます。
手順 3: Metrics Advisor で資格情報エンティティを作成する方法を参照します。これにより、サービスプリンシパルの認証の種類のデータフィードを追加する場合に、そのエンティティを選択できます。
キーコンテナーからのサービスプリンシパル: Key Vault では、クラウドアプリとサービスで使用される暗号化キーとシークレット値を保護するのに役立ちます。 Key Vault を使用すると、キーとシークレットの値を暗号化できます。まず、サービスプリンシパルを作成してから、キーコンテナー内にサービスプリンシパルを格納する必要があります。詳細については、キーコンテナーからのサービスプリンシパルの資格情報エンティティの作成に関するページを参照してください。
クエリ: クエリを指定します。詳細については、「Azure Monitor でのログクエリ」を参照してください。

サンプルクエリ:
```
[TableName]
| where [TimestampColumn] >= datetime(@IntervalStart) and [TimestampColumn] < datetime(@IntervalEnd)
| summarize [count_per_dimension]=count() by [Dimension]
```
詳細については、有効なクエリの作成に関するチュートリアルに関するページを参照してください。

Azure SQL Database | SQL Server

接続文字列: Azure SQL Database および SQL Server の認証の種類は、基本、マネージ ID、Azure SQL 接続文字列、サービスプリンシパル、キーコンテナーからのサービスプリンシパルです。
- 基本: Metrics Advisor では、SQL Server データソース用の ADO.NET スタイルの接続文字列を受け取ります。接続文字列の例を次に示します。
```
Data Source=<Server>;Initial Catalog=<db-name>;User ID=<user-name>;Password=<password>
```
- マネージド ID: Azure リソースに対するマネージド ID では、BLOB およびキューデータへのアクセスを認可できます。これは、Azure 仮想マシン、関数アプリ、仮想マシンスケールセット、その他のサービスで動作するアプリケーションから、Microsoft Entra 資格情報を使用します。 Azure リソースのマネージド ID と Microsoft Entra 認証を使用すると、クラウドで動作するアプリケーションに資格情報を保存することを避けることができます。マネージエンティティを有効にするには、次の手順に従います。
1. システム割り当てマネージド ID の有効化は、1 クリックで行うことができます。 Azure portal の Metrics Advisor ワークスペースで、 [設定]>[アイデンティティ]>[システム割り当て] の順に移動します。次に、[状態] を [オン] に設定します。
2. Microsoft Entra 認証を有効にします。 Azure portal で、データソースの [設定]>[Active Directory 管理者] に移動します。[管理者の設定] を選択し、サーバーの管理者になる Microsoft Entra ユーザーアカウントを選択します。次に [選択] を選択します。
3. Metrics Advisor でマネージド ID を有効にします。データベース管理ツールまたは Azure portal でクエリを編集できます。
  
  管理ツール: データベース管理ツールで、[認証] フィールドの [Active Directory - MFA サポートで汎用] を選択します。 [ユーザー名] フィールドに、手順 2 でサーバー管理者として設定した Microsoft Entra アカウントの名前を入力します。例: test@contoso.com。
  
  Azure portal: SQL データベースで、 [クエリエディター] を選択し、管理者アカウントにサインインします。
  
  次に、クエリウィンドウで次のコマンドを実行します (管理ツールの方法でも同じになることに注意してください)。
```
CREATE USER [MI Name] FROM EXTERNAL PROVIDER
ALTER ROLE db_datareader ADD MEMBER [MI Name]
```
  Note
  
  MI Name は、Metrics Advisor のマネージド ID 名 (サービスプリンシパルの場合は、サービスプリンシパル名に置き換える必要があります)。詳細については、マネージド ID を使用した認可に関するページを参照してください。
  
  接続文字列の例を次に示します。
```
Data Source=<Server>;Initial Catalog=<Database>
```
- Azure SQL 接続文字列:
  
  接続文字列の例を次に示します。
```
Data Source=<Server>;Initial Catalog=<Database>;User ID=<user-name>;Password=<password>
```
- サービスプリンシパル: サービスプリンシパルは、アプリケーションオブジェクトから作成された具象インスタンスであり、そのアプリケーションオブジェクトから特定のプロパティが継承されます。サービスプリンシパルは、アプリケーションが使用される各テナントで作成され、グローバルに一意なアプリオブジェクトが参照されます。サービスプリンシパルオブジェクトには、特定のテナント内でアプリが実際に実行できること、アプリにアクセスできるユーザー、アプリからアクセスできるリソースを定義します。
  
  手順 1: Microsoft Entra アプリケーションを作成して登録し、データベースへのアクセスを認可します。詳細については、「Microsoft Entra アプリの登録を作成する」を参照してください。
  
  手順 2: 前述の手順 (SQL Server のマネージド ID) に従います。
  
  手順 3: Metrics Advisor で資格情報エンティティを作成する方法を参照します。これにより、サービスプリンシパルの認証の種類のデータフィードを追加する場合に、そのエンティティを選択できます。
  
  接続文字列の例を次に示します。
```
Data Source=<Server>;Initial Catalog=<Database>
```
- キーコンテナーからのサービスプリンシパル: Key Vault では、クラウドアプリとサービスで使用される暗号化キーとシークレット値を保護するのに役立ちます。 Key Vault を使用すると、キーとシークレットの値を暗号化できます。まず、サービスプリンシパルを作成してから、キーコンテナー内にサービスプリンシパルを格納する必要があります。詳細については、キーコンテナーからのサービスプリンシパルの資格情報エンティティの作成に関するページを参照してください。接続文字列は、Azure SQL Server リソースの [設定]>[接続文字列] でも確認できます。
  
  接続文字列の例を次に示します。
```
Data Source=<Server>;Initial Catalog=<Database>
```
クエリ: SQL クエリを使用してデータを取得し、多次元時系列データに編成します。クエリで @IntervalStart および @IntervalEnd を使用すると、期待されるメトリック値を一定間隔で取得するのに役立ちます。これらは yyyy-MM-ddTHH:mm:ssZ のように書式設定する必要があります。

サンプルクエリ:
```
SELECT [TimestampColumn], [DimensionColumn], [MetricColumn] FROM [TableName] WHERE [TimestampColumn] >= @IntervalStart and [TimestampColumn] < @IntervalEnd    
```

Azure Table Storage

接続文字列: SAS (Shared Access Signature) URL を作成し、ここに入力します。 SAS URL を生成する最も簡単な方法は、Azure portal を使用することです。最初に、 [設定] で、アクセスするストレージアカウントに移動します。次に、 [Shared Access Signature ] を選択します。 [テーブル] および [オブジェクト] のチェックボックスをオンにし、 [SAS と接続文字列を生成する] を選択します。 Metrics Advisor ワークスペースで、テーブルサービスの SAS URL をコピーして、テキストボックスに入力します。
[テーブル名] : クエリ対象のテーブルを指定します。これは、Azure Storage アカウントインスタンスで確認できます。 [テーブルサービス] セクションで [テーブル] を選択します。
クエリ: クエリで @IntervalStart および @IntervalEndを使用すると、期待されるメトリック値を一定間隔で取得するのに役立ちます。これらは yyyy-MM-ddTHH:mm:ssZ のように書式設定する必要があります。

サンプルクエリ:
```
PartitionKey ge '@IntervalStart' and PartitionKey lt '@IntervalEnd'
```
詳細については、有効なクエリの作成に関するチュートリアルに関するページを参照してください。

InfluxDB (InfluxQL)

接続文字列: InfluxDB にアクセスするための接続文字列。
データベース:クエリ対象のデータベース。

Query: データを取得して、インジェスト用の多次元時系列データに編成するクエリ。

サンプルクエリ:

SELECT [TimestampColumn], [DimensionColumn], [MetricColumn] FROM [TableName] WHERE [TimestampColumn] >= @IntervalStart and [TimestampColumn] < @IntervalEnd

詳細については、有効なクエリの作成に関するチュートリアルに関するページを参照してください。

ユーザー名:これは、認証に対しては省略可能です。
パスワード:これは、認証に対しては省略可能です。

MongoDB

接続文字列: MongoDB にアクセスするための接続文字列。
データベース:クエリ対象のデータベース。
クエリ: データを取得して、インジェスト用の多次元時系列データに編成するコマンド。 db.runCommand() でコマンドを確認します。

サンプルクエリ:
```
{"find": "[TableName]","filter": { [Timestamp]: { $gte: ISODate(@IntervalStart) , $lt: ISODate(@IntervalEnd) }},"singleBatch": true}
```

MySQL

接続文字列: MySQL DB にアクセスするための接続文字列。
Query: データを取得して、インジェスト用の多次元時系列データに編成するクエリ。

サンプルクエリ:
```
SELECT [TimestampColumn], [DimensionColumn], [MetricColumn] FROM [TableName] WHERE [TimestampColumn] >= @IntervalStart and [TimestampColumn]< @IntervalEnd
```
詳細については、有効なクエリの作成に関するチュートリアルに関するページを参照してください。

PostgreSQL

接続文字列: PostgreSQL DB にアクセスするための接続文字列。
Query: データを取得して、インジェスト用の多次元時系列データに編成するクエリ。

サンプルクエリ:
```
SELECT [TimestampColumn], [DimensionColumn], [MetricColumn] FROM [TableName] WHERE [TimestampColumn] >= @IntervalStart and [TimestampColumn] < @IntervalEnd
```
詳細については、有効なクエリの作成に関するチュートリアルに関するページを参照してください。

次のステップ

メトリックデータがシステムに取り込まれるのを待つ間、データフィード構成の管理方法についてお読みください。
メトリックデータが取り込まれたら、メトリックを構成し、検出構成を微調整できます。

次の方法で共有

方法: さまざまなデータソースを接続する

サポートされている認証の種類

データソースおよび対応する認証の種類

Application Insights

Azure Blob Storage (JSON)

Azure Cosmos DB (SQL)

Azure Data Explorer (Kusto)

Azure Data Lake Storage Gen2

Azure Event Hubs

Azure Monitor ログ

Azure SQL Database | SQL Server

Azure Table Storage

InfluxDB (InfluxQL)

MongoDB

MySQL

PostgreSQL

次のステップ

その他のリソース

次の方法で共有

方法: さまざまなデータ ソースを接続する

サポートされている認証の種類

データ ソースおよび対応する認証の種類

Application Insights

Azure Blob Storage (JSON)

Azure Cosmos DB (SQL)

Azure Data Explorer (Kusto)

Azure Data Lake Storage Gen2

Azure Event Hubs

Azure Monitor ログ

Azure SQL Database | SQL Server

Azure Table Storage

InfluxDB (InfluxQL)

MongoDB

MySQL

PostgreSQL

次のステップ

その他のリソース

方法: さまざまなデータソースを接続する

データソースおよび対応する認証の種類