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

重要

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

この記事を使用して、さまざまな種類のデータ ソースを 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 アクセス] を選択します。

      Screenshot that shows how to get the application ID from your Application Insights resource.

    2. Metrics Advisor の [アプリケーション ID] フィールドに生成されたアプリケーション ID をコピーします。

  • API キー: API キーは、このリソースにアクセスするために、ブラウザーの外側のアプリケーションによって使用されます。 API キーを取得するには、次の手順に従います。

    1. Application Insights リソースから、 [API アクセス] を選択します。

    2. [API キーの作成] を選択します。

    3. 簡単な説明を入力し、 [テレメトリを読み取る] オプションを選択して、 [キーの生成] を選択します。

      Screenshot that shows how to get the API key in the Azure portal.

      重要

      この 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 へのアクセスに関するページを参照してください。

      Screenshot that shows a managed identity blob.

  • コンテナー: 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 を使用することもできます。

    サポートされているパラメーターは次のとおりです。

    • %Yyyyy として書式設定された年です。
    • %mMM として書式設定された月です。
    • %ddd として書式設定された日です。
    • %hHH として書式設定された時間です。
    • %Mmm として書式設定された分です。

    たとえば、次のデータセットでは、BLOB テンプレートは %Y/%m/%d/00/JsonFormatV2.json になります。

    Screenshot that shows the blob template.

  • JSON 形式のバージョン:JSON ファイルのデータ スキーマを定義します。 Metrics Advisor では、次のバージョンをサポートしています。 次のいずれかを選択して、フィールドに入力できます。

    • v1

      メトリック NameValue のみが受け入れられます。 次に例を示します。

      {"count":11, "revenue":1.23}
      
    • v2

      メトリック Dimensionstimestamp も受け入れられます。 次に例を示します。

      [
        {"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 です。

      Screenshot that shows managed identity for Kusto.

      接続文字列の例を次に示します。

      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 データ共同作成者] に設定します。 その後、 [保存] を選びます。

      Screenshot that shows the steps to assign roles.

      手順 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 ファイルのディレクトリ テンプレートです。 サポートされているパラメーターは次のとおりです。

    • %Yyyyy として書式設定された年です。
    • %mMM として書式設定された月です。
    • %ddd として書式設定された日です。
    • %hHH として書式設定された時間です。
    • %Mmm として書式設定された分です。

    日次メトリックのクエリ サンプル: %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 の後に追加できます。

    サポートされているパラメーターは次のとおりです。

    • %Yyyyy として書式設定された年です。
    • %mMM として書式設定された月です。
    • %ddd として書式設定された日です。
    • %hHH として書式設定された時間です。
    • %Mmm として書式設定された分です。

    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 のインスタンスに移動します。 次に、新しいポリシーを追加するか、既存の共有アクセス ポリシーを選択します。 ポップアップ パネルで接続文字列をコピーします。 Screenshot of Event Hubs.

    Screenshot of shared access policies.

    接続文字列の例を次に示します。

    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 で確認できます。

    Screenshot that shows where to find the Workspace ID in the Azure portal.

  • サービス プリンシパル: サービス プリンシパルは、アプリケーション オブジェクトから作成された具象インスタンスであり、そのアプリケーション オブジェクトから特定のプロパティが継承されます。 サービス プリンシパルは、アプリケーションが使用される各テナントで作成され、グローバルに一意なアプリ オブジェクトが参照されます。 サービス プリンシパル オブジェクトには、特定のテナント内でアプリが実際に実行できること、アプリにアクセスできるユーザー、アプリからアクセスできるリソースを定義します。

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

    手順 2: ロールを割り当てます。

    1. Azure portal で、 [ストレージ アカウント] サービスに移動します。

    2. [アクセス制御 (IAM)] を選択します。

    3. [+ 追加] を選択し、メニューから [ロールの割り当ての追加] を選択します。

    4. [選択] フィールドを Microsoft Entra アプリケーション名に設定し、ロールを [ストレージ BLOB データ共同作成者] に設定します。 その後、 [保存] を選びます。

      Screenshot that shows how to assign roles.

    手順 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 ワークスペースで、 [設定]>[アイデンティティ]>[システム割り当て] の順に移動します。 次に、[状態] を [オン] に設定します。

      Screenshot that shows how to set the status as on.

    2. Microsoft Entra 認証を有効にします。 Azure portal で、データ ソースの [設定]>[Active Directory 管理者] に移動します。[管理者の設定] を選択し、サーバーの管理者になる Microsoft Entra ユーザー アカウントを選択します。 次に [選択] を選択します。

      Screenshot that shows how to set the admin.

    3. Metrics Advisor でマネージド ID を有効にします。 データベース管理ツールまたは Azure portal でクエリを編集できます。

      管理ツール: データベース管理ツールで、[認証] フィールドの [Active Directory - MFA サポートで汎用] を選択します。 [ユーザー名] フィールドに、手順 2 でサーバー管理者として設定した Microsoft Entra アカウントの名前を入力します。 例: test@contoso.com

      Screenshot that shows how to set connection details.

      Azure portal: SQL データベースで、 [クエリ エディター] を選択し、管理者アカウントにサインインします。 Screenshot that shows how to edit your query in the Azure portal.

      次に、クエリ ウィンドウで次のコマンドを実行します (管理ツールの方法でも同じになることに注意してください)。

      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 をコピーして、テキスト ボックスに入力します。

    Screenshot that shows how to generate the shared access signature in Azure Table Storage.

  • [テーブル名] : クエリ対象のテーブルを指定します。 これは、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
    

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

次のステップ