アナリティクスコンシュームゾーンを有効にする

Azure Data Manager for Energyのネイティブ分析機能は、分析消費ゾーン(ACZ)を通じて提供され、エネルギーデータを分析やAIに容易に利用できるようにします。 ADMEは選択したOSDU®データをオープンなDelta Parquet形式で顧客所有のストレージに同期し、Microsoft Fabric、Azure Databricks、Snowflake、その他の互換性のある分析プラットフォームで利用できるようにすることで、カスタムデータパイプラインを構築・保守する必要をなくします。

この記事では、Azure Data Manager for Energy リソースで分析消費ゾーン (ACZ) 機能を有効にする方法について説明します。有効化は、Azure Data Manager for Energy リソース、ユーザー割り当てマネージド ID、ストレージアカウントを構成する 1 回限りのセットアッププロセスです。有効化後、複数の ACZ インスタンスを作成して、異なる Azure Data Manager for Energy データセットをAzure Data Lake Storage Gen2 アカウントに同期できます。

Azure Data Manager for EnergyリソースでACZを有効にするには、この記事の手順に従ってください。

セットアップの概要

ACZ の設定には、次の 2 つの手順があります:

AzureポータルのAzure Data Manager for Energy resourceでACZを有効にしてください。このステップは各リソースごとに一度ずつ行います。
ACZ APIを使って1つ以上のACZインスタンスを作成します。 ACZインスタンスは、ACZがエクスポートするデータと書き込み先のストレージ場所を定義します。各データパーティションで最大3つのACZインスタンスを作成できます。

ACZはACZインスタンスを作成するまでデータをエクスポートしません。

このセットアップでは、ACZ が Azure Data Manager for Energy データにアクセスし、Data Lake Storage Gen2に書き込むためのマネージド ID を構成します。

Azure Data Manager for Energy リソースで ACZ を有効にするには、次の 1 回限りのセットアップタスクを完了します。有効化後、API を使用して複数の ACZ インスタンスを作成できます。

Tip

ACZ 構成を計画します。 ACZ インスタンスを作成する前に、次のものが必要かどうかを判断します。

すべてのカタログデータ: allCatalogSync: true (構成セクションの外部) を設定して、パーティションからすべてのカタログエンティティの種類をエクスポートします。
特定のエンティティ型: 構成セクションの catalogKinds 配列を使用して、選択した種類 (ウェル、ウェルボー、フィールドなど) のみをエクスポートします。

allCatalogSync が true の場合、カタログデータに関しては catalogKinds と wellboreDDMSKinds (プレビュー) 配列は無視されます。 Wellbore Domain データ管理 Service (DDMS) の一括ファイルのダウンロードは、wellboreDDMSKindsに記載されている種類に対してのみ行われます。

構成例については、「チュートリアル: ACZ API を使用する」を参照してください。

Step	Task
1	既存のData Lake Storage Gen2 ストレージアカウントを作成または使用します。
2	ACZ のユーザー割り当てマネージド ID を作成します。
3	Azure portal で ACZ を有効にし、ユーザーが割り当てたマネージド ID を割り当てます。
4	ユーザーがエンタイトルメントグループアクセス権を持っていることを確認します。
5	ユーザー割り当てマネージド ID ストレージのアクセス許可を付与します。

Tip

OSDUのEntitlementsメンバーシップデータを分析プラットフォームの行レベルフィルタリング用にエクスポートするには、Analytics Consumption Zone (プレビュー) でのEntitlementsのエクスポートをご覧ください。

前提条件

有効な Azure サブスクリプション。サブスクリプションを無料で作成します。
少なくとも1つのデータパーティションを持つAzure Data Manager for Energyインスタンス(開発者または標準層)を用意してください。 Azure Data Manager for Energy インスタンスを作成します。
Azure CLIコンピューターにインストールされているか、Azure Cloud Shellにアクセスします。

手順 1: 既存のData Lake Storage Gen2 ストレージアカウントを作成または使用する

ACZ には、同期されたデータを格納するために階層型名前空間が有効になっているAzure Data Lake Storage Gen2ストレージアカウントが必要です。まだお持ちでない場合は、作成します。

Azure ポータルで、リソースの作成>Storage アカウント を選択します。
[ 基本 ] タブで、サブスクリプションとリソースグループを選択します。
ストレージアカウント名を入力し、希望するリージョンを選択します。
[ 詳細設定 ] タブで、[ 階層型名前空間を有効にする] を選択します。
[確認と作成] を選択し、次に [作成] を選択します。

Important

ACZは、場所に関係なく、指定した Data Lake Storage Gen2 ストレージアカウントにデータをエクスポートします。ストレージアカウントがAzure Data Manager for Energyリソースとは異なるAzureリージョンにある場合、データはリソースのリージョン外にコピーされます。推奨される配置については、Azure Data Manager for Energy リソースと同じリージョン内のストレージアカウントを使いましょう。 ACZは同じ地域限定の制限を適用していません。データレジデンシー要件がある場合は、適切な地域でストレージアカウントを選択してください。

Note

現在、ACZ では、宛先のストレージアカウントがパブリックネットワークへのアクセスを許可している必要があります。ファイアウォールのIPルールやパブリックネットワークアクセスの無効化、プライベートエンドポイントでアクセスを制限するストレージアカウントはサポートされていません。この要件は宛先のストレージアカウントにのみ適用されます。 ACZ API は、プライベートエンドポイントを使用する Azure Data Manager for Energy のインスタンスで利用可能です。

手順 2: ACZ のユーザー割り当てマネージド ID を作成する

ACZ は、ユーザー割り当てマネージド ID を使用してData Lake Storage Gen2にデータを書き込むため、ACZ の専用 ID を作成する必要があります。

Important

Microsoftは、顧客管理キー(CMK)や外部データソース(EDS)など他のサービスのIDを再利用するのではなく、ACZ用に専用のユーザー割り当てマネージドアイデンティティを作成することを推奨しています。専用 ID では、次の機能が提供されます。

監査証跡をクリアする: ID を分離すると、監査ログで ACZ 固有の操作を簡単に追跡できます。
独立したライフサイクル管理: 独立した制御により、他のサービスに影響を与えることなく、ACZ ID をローテーション、更新、または削除できます。
きめ細かいアクセス制御: ACZ ID は、不要なアクセス許可を継承することなく、必要なアクセス許可 (ストレージ BLOB データ共同作成者) のみを取得します。
トラブルシューティングの簡素化:ACZ権限の問題はCMK、EDS、その他のサービスには影響しません。

ユーザー割り当てマネージド ID を作成するには:

Azure ポータルで、Managed Identities を検索して選択します。
[+ 作成] を選択します。
サブスクリプション、リソースグループ、リージョンを選択し、ID の名前を指定します。
[確認と作成] を選択し、次に [作成] を選択します。

ステップ 3: ACZ を有効にし、ユーザーに割り当てられたマネージド ID を割り当てる

Azure Data Manager for EnergyリソースでACZを有効にし、ステップ2で作成したユーザー割り当てのマネージデンティティを選択してください。

Note

Analytics Consumption Zoneはオプションの請求可能な機能です。有効化すると課金が開始されます。価格を見る。

Azure Portal で Azure Data Manager for Energy リソースに移動します。
左側メニューのAdvancedの下で、Analytics Consumption Zoneを選択します。
「Analytics Consumption Zoneを有効にする」チェックボックスをオンにしてください。
ユーザー指定の ID の横にあるユーザー ID を選択するを選択して、フォームを開きます。
ステップ2で作成したサブスクリプションとユーザー割り当てのマネージドアイデンティティを選択し、「追加」を選択します。選択できるIDは1つだけです。既存のアイデンティティを再利用する場合は、そのアイデンティティを選択してください。
[保存] を選択して構成を適用します。

設定保存後、「 Enable Analytics Consumption Zone 」は選択済みで利用不可と表示され、「 User-assigned Identity 」は選択したIDを表示します。

Important

ACZを有効にした後は、Azureポータルで無効にすることはできません。 Azure Data Manager for EnergyリソースでACZを無効にするには、サポートリクエストを作成してください。

Important

ACZを有効にしてもデータのエクスポートは始まりません。エクスポートを始めるには、残りのステップを完了してから ACZインスタンスを作成してください。

手順 4: ユーザーがエンタイトルメントグループアクセス権を持っていることを確認する

ACZ API を呼び出すには、ユーザー (ユーザー) が次のエンタイトルメントグループのメンバーである必要があります。

users@{data-partition-id}.dataservices.energy
users.datalake.ops@{data-partition-id}.dataservices.energy
service.entitlements.user@{data-partition-id}.dataservices.energy

この手順では、 ユーザー 割り当てマネージド ID ではなく、ユーザー (ACZ API を呼び出すユーザー) がアクセス権を持っていることを確認します。手順 2 で作成したユーザー割り当てマネージド ID は、ストレージにデータを書き込む場合にのみ ACZ によって使用されます。エンタイトルメントグループのメンバーシップは不要です。

これらのエンタイトルメントグループのメンバーでない場合は、Azure Data Manager for Energy 管理者にユーザーアカウントを追加してもらう必要があります。詳細な手順については、「Azure Data Manager for Energy でユーザーを管理する」を参照してください。

アクセス権があることを確認するには、Entitlements Service API を使用して、3 つのグループすべてへの所属状況を確認してください。

Bash
PowerShell

# Check users group membership
curl --http1.1 --request GET \
  --url https://{base_url}/api/entitlements/v2/groups/users@{data-partition-id}.dataservices.energy/members \
  --header 'Authorization: Bearer {access_token}' \
  --header 'data-partition-id: {data-partition-id}'

# Check users.datalake.ops group membership
curl --http1.1 --request GET \
  --url https://{base_url}/api/entitlements/v2/groups/users.datalake.ops@{data-partition-id}.dataservices.energy/members \
  --header 'Authorization: Bearer {access_token}' \
  --header 'data-partition-id: {data-partition-id}'

# Check service.entitlements.user group membership
curl --http1.1 --request GET \
  --url https://{base_url}/api/entitlements/v2/groups/service.entitlements.user@{data-partition-id}.dataservices.energy/members \
  --header 'Authorization: Bearer {access_token}' \
  --header 'data-partition-id: {data-partition-id}'

# Check users group membership
Invoke-RestMethod -Uri "https://{base_url}/api/entitlements/v2/groups/users@{data-partition-id}.dataservices.energy/members" -Method Get -Headers @{
    "Authorization" = "Bearer {access_token}"
    "data-partition-id" = "{data-partition-id}"
}

# Check users.datalake.ops group membership
Invoke-RestMethod -Uri "https://{base_url}/api/entitlements/v2/groups/users.datalake.ops@{data-partition-id}.dataservices.energy/members" -Method Get -Headers @{
    "Authorization" = "Bearer {access_token}"
    "data-partition-id" = "{data-partition-id}"
}

# Check service.entitlements.user group membership
Invoke-RestMethod -Uri "https://{base_url}/api/entitlements/v2/groups/service.entitlements.user@{data-partition-id}.dataservices.energy/members" -Method Get -Headers @{
    "Authorization" = "Bearer {access_token}"
    "data-partition-id" = "{data-partition-id}"
}

プレースホルダーを置き換える

プレースホルダー	Description
`{base_url}`	Azure Data Manager for Energy リソースの URL (`myinstance.energy.azure.com` など)。
`{access_token}`	Azure Data Manager for Energy API の個人用アクセストークン。認証トークンの生成を参照してください。
`{data-partition-id}`	データパーティション ID (たとえば、 `dp1`)。

サンプル応答

{
  "desId": "users@dp1.dataservices.energy",
  "name": "users@dp1.dataservices.energy",
  "description": "Datalake users",
  "email": "users@dp1.dataservices.energy",
  "members": [
    {
      "email": "user@example.com",
      "role": "MEMBER"
    },
    {
      "email": "admin@example.com",
      "role": "OWNER"
    }
  ]
}

3つの回答すべてには、members 配列内にあなたのユーザーアカウントが含まれている必要があります。いずれのグループにも含まれていない場合は、Azure Data Manager for Energy管理者に連絡し、必須の3つのグループすべてに追加してもらう必要があります。

手順 5: Data Lake Storage Gen2 コンテナーに対するユーザー割り当てマネージド ID のアクセス許可を付与する

ユーザー割り当てマネージド ID に、Data Lake Storage Gen2 ストレージアカウントへの書き込みアクセス権を付与します。 ACZ ID には、Delta Parquet ファイルを書き込むには、ストレージ BLOB データ共同作成者のアクセス許可が必要です。

Azure ポータルで、Data Lake Storage Gen2 ストレージアカウントに移動します。
左側のメニューから [アクセス制御 (IAM)] を選択します。
[+ 追加] を選択>ロールの割り当てを追加します。
[ ロール ] タブで、 ストレージ BLOB データ共同作成者を検索して選択し、[ 次へ] を選択します。
[ メンバー ] タブの [ アクセスの割り当て] で、[ マネージド ID] を選択します。
次に、[メンバーの選択] を選択します。
[ マネージド ID ] ドロップダウンリストで、[ ユーザー割り当てマネージド ID] を選択します。
ステップ 2 で作成したユーザー割り当てマネージド ID を選択し、次に選択を選択します。既存のアイデンティティを再利用する場合、たとえばカスタマーマネージドキー(CMK) や外部データサービス(EDS) に使用しているアイデンティティがあれば、代わりにそのアイデンティティを選択してください。
[ 確認と割り当て] を選択してロールの割り当てを完了します。

ACZ インスタンスを作成する

有効化手順が完了したら、1 つ以上の ACZ インスタンスを作成して、Azure Data Manager for Energy データをData Lake Storage Gen2に同期できます。異なるデータ型を同期するように各 ACZ インスタンスを構成できます。

Note

既存のACZ定義を編集することはできません。たとえば、種類を追加または削除するといったことはできません。定義を変更するには、必要な構成で新しいACZを作成してください。各 ACZ には固有の識別子と出力パスが割り当てられているため、下流のテーブル、ショートカット、または外部の保存先を更新して、新しい ACZ を参照してください。

ACZ Create API を呼び出す

ACZ Create API を使用して ACZ インスタンスを作成します。完全なチュートリアルについては、「チュートリアル: ACZ API を使用する」を参照してください。

Bash
PowerShell

curl --http1.1 --request POST \
  --url https://{base_url}/api/acz/v1/aczs \
  --header 'Authorization: Bearer {access_token}' \
  --header 'Content-Type: application/json' \
  --header 'data-partition-id: {data_partition_id}' \
  --data '{
    "name": "my-first-acz",
    "allCatalogSync": false,
    "sink": {
      "storageId": "/subscriptions/{sub-id}/resourceGroups/{rg}/providers/Microsoft.Storage/storageAccounts/{account}"
    },
    "configuration": {
      "catalogKinds": [
        "osdu:wks:master-data--Well:*",
        "osdu:wks:reference-data--UnitOfMeasure:*"
      ],
      "wellboreDDMSKinds": [
        "osdu:wks:work-product-component--WellLog:*"
      ]
    }
  }'

# Build request body
$body = @{
    name = "my-first-acz"
    allCatalogSync = $false
    sink = @{
        storageId = "/subscriptions/{sub-id}/resourceGroups/{rg}/providers/Microsoft.Storage/storageAccounts/{account}"
    }
    configuration = @{
        catalogKinds = @(
            "osdu:wks:master-data--Well:*",
            "osdu:wks:reference-data--UnitOfMeasure:*"
        )
        wellboreDDMSKinds = @(
            "osdu:wks:work-product-component--WellLog:*"
        )
    }
} | ConvertTo-Json -Depth 10

# Create ACZ
Invoke-RestMethod -Uri "https://{base_url}/api/acz/v1/aczs" -Method Post -Headers @{
    "Authorization" = "Bearer {access_token}"
    "Content-Type" = "application/json"
    "data-partition-id" = "{data_partition_id}"
} -Body $body

プレースホルダーを置き換える

プレースホルダー	Description
`{base_url}`	Azure Data Manager for Energy リソースの URL (`myinstance.energy.azure.com` など)。
`{access_token}`	Azure Data Manager for Energy API のアクセストークン。認証トークンの生成を参照してください。
`{data_partition_id}`	データパーティション ID (たとえば、 `dp1`)。
`{sub-id}`	Data Lake Storage Gen2 ストレージアカウントが存在するサブスクリプション ID。
`{rg}`	Data Lake Storage Gen2 ストレージアカウントが存在するリソースグループ。
`{account}`	Data Lake Storage Gen2 ストレージアカウントの名前。

応答が成功すると、ACZ の詳細と共に HTTP 状態 201 が返されます。

{
  "aczId": "acz-8a0aa7433085",
  "name": "my-first-acz",
  "status": "ACTIVE",
  "targetFormat": "DELTA_PARQUET",
  "aczType": "LATEST_VERSION",
  "sink": {
    "storageType": "microsoft.storage/storageaccounts",
    "storageId": "/subscriptions/{sub-id}/resourceGroups/{rg}/providers/Microsoft.Storage/storageAccounts/{account}",
    "basePath": ""
  },
  "allCatalogSync": false,
  "configuration": {
    "catalogKinds": [
      "osdu:wks:master-data--Well:*",
      "osdu:wks:reference-data--UnitOfMeasure:*"
    ],
    "wellboreDDMSKinds": [
      "osdu:wks:work-product-component--WellLog:*"
    ]
  },
  "historicalSnapshotStatus": "PROCESSING",
  "createdTs": "2026-05-01T12:00:00.000000",
  "updatedTs": "2026-05-01T12:00:00.000000",
  "createdBy": "your-user-object-id"
}

aczId の値を書き留めておいてください。 APIを使ってACZインスタンスを管理・クエリし、以下の表に示すようにストレージ内のデータを見つけるために必要です。

オプションの basePath プロパティは、ACZがストレージアカウントにデータを書き込む場所を決定します:

`basePath`	データの場所
指定なし	`<aczId>/<aczId>/`
`analytics`	`analytics/<aczId>/`
`analytics/workbench`	`analytics/workbench/<aczId>/`

データロケーションの最初のセグメントはコンテナです。 ACZは basePath の最初のセグメントをコンテナ名として使います。ベースパスを指定しなければ aczId を使い、存在しなければコンテナを作成します。最初のセグメントは有効なコンテナ名でなければなりません。命名ルールについては、「コンテナ、ブロブ、メタデータの命名と参照」を参照してください。追加の basePath セグメントはそのコンテナ内のフォルダとして作成されます。最初のセグメントはコンテナ命名ルールに従う必要があります:3文字から63文字、小文字、数字、ハイフンを使用します。

Tip

Swagger UI またはサンプルリクエストから ACZ を作成する場合は、プレースホルダー basePath の値を置き換えてください。例えば、Swagger のデフォルト値 string は、string という名前のコンテナを作成します。

ACZインスタンスを作成すると、ACZは選択したデータの履歴スナップショットを取得します。進捗を確認するには、Get ACZ APIを呼び出して status と historicalSnapshotStatus フィールドを確認してください。 historicalSnapshotStatusがCOMPLETEDされると、最初のエクスポートが完了し、ACZは新しい変更を同期し続けます。詳細はチュートリアル「 ACZ APIの使用」をご覧ください。

Analytics 従量課金ゾーンのコンセプト
チュートリアル: ACZ API を使用する
ACZ データを Microsoft Fabric
ACZ データを Azure Databricks
ACZデータをSnowflakeに接続する
Analytics Consumption Zone(プレビュー)におけるエンタイトルメントのエクスポート

フィードバック

このページはお役に立ちましたか?

最終更新: 2026-10-30

アナリティクス コンシューム ゾーンを有効にする

セットアップの概要

前提条件

手順 1: 既存のData Lake Storage Gen2 ストレージ アカウントを作成または使用する

手順 2: ACZ のユーザー割り当てマネージド ID を作成する

ステップ 3: ACZ を有効にし、ユーザーに割り当てられたマネージド ID を割り当てる

手順 4: ユーザーがエンタイトルメント グループアクセス権を持っていることを確認する

プレースホルダーを置き換える

サンプル応答

手順 5: Data Lake Storage Gen2 コンテナーに対するユーザー割り当てマネージド ID のアクセス許可を付与する

ACZ インスタンスを作成する

ACZ Create API を呼び出す

プレースホルダーを置き換える

関連するコンテンツ

フィードバック

その他のリソース

アナリティクスコンシュームゾーンを有効にする

手順 1: 既存のData Lake Storage Gen2 ストレージアカウントを作成または使用する

手順 4: ユーザーがエンタイトルメントグループアクセス権を持っていることを確認する