Włącz strefę korzystania z analityki

W tym artykule opisano sposób włączania możliwości analizy strefy zużycia (ACZ) na Azure Data Manager for Energy resource. Włączenie to jednorazowy proces konfiguracji, podczas którego konfigurowane są zasób Azure Data Manager for Energy, tożsamość zarządzana przypisana przez użytkownika oraz konto magazynowe. Po włączeniu można utworzyć wiele wystąpień usługi ACZ w celu zsynchronizowania różnych zestawów danych usługi Azure Data Manager for Energy z kontem Azure Data Lake Storage Gen2.

W wersji zapoznawczej usługa ACZ jest dostępna tylko w wystąpieniach w warstwie Developer i wymaga stosowania list dozwolonych. Aby włączyć usługę ACZ dla zasobu Azure Data Manager for Energy, wykonaj kroki opisane w tym artykule i skontaktuj się z przedstawicielem Microsoft.

Omówienie instalacji

Konfiguracja ustawia tożsamość zarządzaną, która umożliwia usłudze ACZ dostęp do danych w usłudze Azure Data Manager for Energy oraz zapisywanie ich w usłudze Data Lake Storage Gen2.

Wykonaj następujące jednorazowe zadania konfiguracji, aby włączyć usługę ACZ na zasobie Azure Data Manager for Energy. Po włączeniu tej funkcji można tworzyć wiele wystąpień ACZ za pomocą interfejsów API.

Wymagania wstępne

• Aktywna subskrypcja platformy Azure. Utwórz bezpłatnie subskrypcję.
• Wystąpienie Azure Data Manager for Energy (warstwa Deweloper) z co najmniej jedną partycją danych. Utwórz wystąpienie usługi Azure Data Manager dla usługi Energy.
• Na komputerze zainstalowano Azure CLI lub dostęp do Azure Cloud Shell.

Krok 1. Tworzenie lub używanie istniejącego konta magazynu Data Lake Storage Gen2

ACZ wymaga konta magazynu Azure Data Lake Storage Gen2 z włączoną hierarchiczną przestrzenią nazw do przechowywania zsynchronizowanych danych. Jeśli jeszcze go nie masz, utwórz go.

1. W portalu Azure wybierz pozycję Utwórz zasób>Konto magazynu.
2. Na karcie Podstawy wybierz swoją subskrypcję i grupę zasobów.
3. Wprowadź nazwę konta magazynu i wybierz preferowany region.
4. Na karcie Zaawansowane wybierz pozycję Włącz hierarchiczną przestrzeń nazw.
5. Wybierz Przejrzyj + utwórz, a następnie wybierz Utwórz.

Jeśli masz wymagania dotyczące rezydencji danych, odpowiadasz za wybranie konta magazynu docelowego w lokalizacji geograficznej. Usługa ACZ eksportuje dane do określonego konta magazynu Data Lake Storage Gen2 niezależnie od lokalizacji.

Krok 2. Tworzenie tożsamości zarządzanej przypisanej przez użytkownika dla usługi ACZ

Usługa ACZ używa tożsamości zarządzanej przypisanej przez użytkownika do zapisywania danych w Data Lake Storage Gen2, dlatego należy utworzyć dedykowaną tożsamość dla usługi ACZ.

Aby utworzyć tożsamość zarządzaną przypisaną przez użytkownika:

1. W portalu Azure wyszukaj Managed Identities i wybierz go.
2. Wybierz + Utwórz.
3. Wybierz swoją subskrypcję, grupę zasobów i region i podaj nazwę tożsamości.
4. Wybierz Przejrzyj + utwórz, a następnie wybierz Utwórz.

Krok 3. Przypisanie tożsamości zarządzanej przypisanej przez użytkownika do zasobu Azure Data Manager for Energy

Przypisz tożsamość zarządzaną przypisaną przez użytkownika, utworzoną w kroku 2., do zasobu Azure Data Manager for Energy.

Postępuj zgodnie z tymi trzema krokami podrzędnymi, aby bezpiecznie dołączyć tożsamość zarządzaną.

Krok 3.1. Pobieranie bieżącej konfiguracji

Pobierz kompletną konfigurację wystąpienia Azure Data Manager for Energy.

# Set your Azure Data Manager for Energy instance details
SUBSCRIPTION_ID="{subscription-id}"
RESOURCE_GROUP="{resource-group}"
ADME_INSTANCE_NAME="{adme-instance-name}"

# Get Azure Resource Manager token
TOKEN=$(az account get-access-token --resource "https://management.azure.com/" --query accessToken -o tsv | tr -d '\r')

# Get current Azure Data Manager for Energy instance configuration
curl --http1.1 --request GET \
  --url "https://management.azure.com/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP/providers/Microsoft.OpenEnergyPlatform/energyServices/$ADME_INSTANCE_NAME?api-version=2025-12-15" \
  --header "Authorization: Bearer $TOKEN" \
  > adme-config.json

# View the configuration
cat adme-config.json | jq .

# Set your Azure Data Manager for Energy instance details
$subscriptionId = "{subscription-id}"
$resourceGroup = "{resource-group}"
$admeInstanceName = "{adme-instance-name}"

# Get Azure Resource Manager token
$token = az account get-access-token --resource "https://management.azure.com/" --query accessToken -o tsv

# Get current Azure Data Manager for Energy instance configuration
$uri = "https://management.azure.com/subscriptions/$subscriptionId/resourceGroups/$resourceGroup/providers/Microsoft.OpenEnergyPlatform/energyServices/$admeInstanceName`?api-version=2025-12-15"

Invoke-RestMethod -Uri $uri -Method Get `
  -Headers @{ "Authorization" = "Bearer $token" } `
  | ConvertTo-Json -Depth 10 `
  | Out-File adme-config.json

# View the configuration (displays full JSON without truncation)
Get-Content adme-config.json

Zastąp symbole zastępcze

Polecenie wyświetla pełną konfigurację w formacie JSON bez przycinania. adme-config.json Uważnie przejrzyj zawartość pliku. Musisz skopiować z niego określone wartości dla kroku 3.2.

Krok 3.2. Aktualizowanie konfiguracji przy użyciu tożsamości zarządzanej

Zaktualizuj konfigurację, dodając tożsamość zarządzaną, zachowując wszystkie istniejące właściwości.

# Set your Azure Data Manager for Energy instance details
SUBSCRIPTION_ID="{subscription-id}"
RESOURCE_GROUP="{resource-group}"
ADME_INSTANCE_NAME="{adme-instance-name}"
MI_RESOURCE_ID="{managed-identity-resource-id}"

# Get Azure Resource Manager token
TOKEN=$(az account get-access-token --resource "https://management.azure.com/" --query accessToken -o tsv | tr -d '\r')

# Update Azure Data Manager for Energy instance with managed identity
# IMPORTANT: Replace {paste-entire-properties-block-from-GET} with the complete "properties" object from adme-config.json
# IMPORTANT: Replace {paste-all-existing-identities-from-GET} with all entries from identity.userAssignedIdentities, then add new MI
# IMPORTANT: Replace {paste-tags-from-GET} with the complete "tags" object from adme-config.json (or {} if no tags exist)
curl --http1.1 --request PUT \
  --url "https://management.azure.com/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP/providers/Microsoft.OpenEnergyPlatform/energyServices/$ADME_INSTANCE_NAME?api-version=2025-12-15" \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "location": "{use-location-from-GET}",
    "properties": {paste-entire-properties-block-from-GET},
    "identity": {
      "type": "UserAssigned",
      "userAssignedIdentities": {
        {paste-all-existing-identities-from-GET},
        "'"$MI_RESOURCE_ID"'": {}
      }
    },
    "tags": {paste-tags-from-GET}
  }'

# Set your Azure Data Manager for Energy instance details
$subscriptionId = "{subscription-id}"
$resourceGroup = "{resource-group}"
$admeInstanceName = "{adme-instance-name}"
$miResourceId = "{managed-identity-resource-id}"

# Get Azure Resource Manager token
$token = az account get-access-token --resource "https://management.azure.com/" --query accessToken -o tsv

# Update Azure Data Manager for Energy instance with managed identity
# IMPORTANT: Replace {paste-entire-properties-block-from-GET} with the complete "properties" object from adme-config.json
# IMPORTANT: Replace {paste-all-existing-identities-from-GET} with all entries from identity.userAssignedIdentities, then add new MI
# IMPORTANT: Replace {paste-tags-from-GET} with the complete "tags" object from adme-config.json (or {} if no tags exist)
$uri = "https://management.azure.com/subscriptions/$subscriptionId/resourceGroups/$resourceGroup/providers/Microsoft.OpenEnergyPlatform/energyServices/$admeInstanceName`?api-version=2025-12-15"

$body = @"
{
  "location": "{use-location-from-GET}",
  "properties": {paste-entire-properties-block-from-GET},
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      {paste-all-existing-identities-from-GET},
      "$miResourceId": {}
    }
  },
  "tags": {paste-tags-from-GET}
}
"@

Invoke-RestMethod -Uri $uri -Method Put `
  -Headers @{ "Authorization" = "Bearer $token"; "Content-Type" = "application/json" } `
  -Body $body

Zastąp symbole zastępcze

Krok 3.3. Weryfikowanie załącznika tożsamości zarządzanej

Upewnij się, że tożsamość zarządzana została pomyślnie dołączona do wystąpienia usługi Azure Data Manager for Energy.

# Set your Azure Data Manager for Energy instance details (if not already set from previous steps)
SUBSCRIPTION_ID="{subscription-id}"
RESOURCE_GROUP="{resource-group}"
ADME_INSTANCE_NAME="{adme-instance-name}"

# Get Azure Resource Manager token
TOKEN=$(az account get-access-token --resource "https://management.azure.com/" --query accessToken -o tsv | tr -d '\r')

# Get current managed identities
curl --http1.1 --request GET \
  --url "https://management.azure.com/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP/providers/Microsoft.OpenEnergyPlatform/energyServices/$ADME_INSTANCE_NAME?api-version=2025-12-15" \
  --header "Authorization: Bearer $TOKEN" \
  | jq '.identity.userAssignedIdentities | keys'

# Set your Azure Data Manager for Energy instance details (if not already set from previous steps)
$subscriptionId = "{subscription-id}"
$resourceGroup = "{resource-group}"
$admeInstanceName = "{adme-instance-name}"

# Get Azure Resource Manager token
$token = az account get-access-token --resource "https://management.azure.com/" --query accessToken -o tsv

# Set URI
$uri = "https://management.azure.com/subscriptions/$subscriptionId/resourceGroups/$resourceGroup/providers/Microsoft.OpenEnergyPlatform/energyServices/$admeInstanceName`?api-version=2025-12-15"

# Get current managed identities
$config = Invoke-RestMethod -Uri $uri -Method Get `
  -Headers @{ "Authorization" = "Bearer $token" }

$config.identity.userAssignedIdentities.PSObject.Properties.Name

Zastąp symbole zastępcze

Jeśli uruchomisz wszystkie podkroki w tej samej sesji terminalu, zmienne są już ustawione z kroku 3.1 i kroku 3.2.

Przykładowe dane wyjściowe

[
  "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/my-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-acz-identity"
]

Dane wyjściowe powinny zawierać identyfikator zasobu tożsamości zarządzanej. Jeśli masz przypisane inne tożsamości (CMEK, EDS), również pojawią się one na liście.

Krok 4. Sprawdzanie, czy użytkownik ma dostęp do grupy uprawnień

Aby wywołać interfejsy API ACZ, użytkownik (użytkownik) musi być członkiem następujących grup uprawnień:

• users@{data-partition-id}.dataservices.energy
• users.datalake.ops@{data-partition-id}.dataservices.energy

Ten krok sprawdza, czy użytkownik wywołujący interfejsy API ACZ ma dostęp, a nie tożsamość zarządzaną przypisaną przez użytkownika. Tożsamość zarządzana przypisana przez użytkownika, utworzona w kroku 2, jest używana wyłącznie przez ACZ do zapisywania danych do magazynu. Nie wymaga członkostwa w grupie uprawnień.

Jeśli nie jesteś jeszcze członkiem tych grup uprawnień, poproś administratora usługi Azure Data Manager for Energy o dodanie Twojego konta użytkownika. Aby uzyskać szczegółowe instrukcje, zobacz Zarządzanie użytkownikami w programie Azure Data Manager for Energy.

Aby sprawdzić, czy masz dostęp, użyj interfejsu API usługi Upoważnienia, aby sprawdzić członkostwo w obu grupach.

# 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 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}"
}

Zastąp symbole zastępcze

Przykładowa odpowiedź

{
  "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"
    }
  ]
}

Obie odpowiedzi powinny obejmować konto użytkownika w tablicy members. Jeśli nie jesteś wymieniony w żadnej grupie, skontaktuj się z administratorem Azure Data Manager for Energy, aby dodać Cię do obu wymaganych grup.

Krok 5. Udzielanie uprawnień tożsamości zarządzanej przypisanej przez użytkownika do kontenera Data Lake Storage Gen2

Udziel przypisanej przez użytkownika tożsamości zarządzanej dostępu do zapisu na koncie magazynu Data Lake Storage Gen2. Tożsamość ACZ musi mieć uprawnienia Storage Blob Data Contributor, aby zapisywać pliki Delta Parquet.

1. Przejdź do konta usługi Data Lake Storage Gen2 w portalu Azure.
2. Z menu po lewej stronie wybierz opcję Kontrola dostępu (IAM).
3. Wybierz pozycję + Dodaj>Dodaj przypisanie roli.
4. Na karcie Rola wyszukaj pozycję Współautor danych obiektu blob usługi Storage, wybierz ją, a następnie wybierz pozycję Dalej.
5. Na karcie Członkowie w polu Przypisz dostęp do wybierz pozycję Tożsamość zarządzana.
6. Wybierz + Wybierz członków.
7. Z listy rozwijanej Tożsamość zarządzana wybierz pozycję Tożsamość zarządzana przypisana przez użytkownika.
8. Wybierz tożsamość zarządzaną przypisaną przez użytkownika utworzoną w kroku 2 (lub istniejącą tożsamość CMEK/EDS), a następnie wybierz pozycję Wybierz.
9. Wybierz Przejrzyj i przypisz, aby zakończyć przypisanie roli.

Krok 6. Udostępnij firmie Microsoft szczegóły tożsamości zarządzanej przypisanej przez użytkownika oraz wystąpienia usługi Azure Data Manager for Energy (wymaganie dotyczące wersji zapoznawczej)

W okresie obowiązywania wersji zapoznawczej dostęp do usługi ACZ wymaga użycia list dozwolonych. Microsoft musi włączyć funkcję ACZ w wystąpieniu usługi Azure Data Manager for Energy i skonfigurować ją przy użyciu tożsamości zarządzanej przypisanej przez użytkownika. Udostępnij następujące informacje kontaktowi Microsoft, aby zakończyć włączanie usługi ACZ.

Podaj następujące informacje przedstawicielowi Microsoft.

Gdy firma Microsoft doda Twoją tożsamość zarządzaną przypisaną przez użytkownika do listy dozwolonych elementów, funkcja ACZ zostanie włączona w zasobie Azure Data Manager for Energy.

Utwórz instancję ACZ

Po zakończeniu kroków konfiguracji możesz utworzyć co najmniej jedno wystąpienie ACZ, aby synchronizować dane z usługi Azure Data Manager for Energy z usługą Data Lake Storage Gen2. Każde wystąpienie usługi ACZ można skonfigurować tak, aby synchronizowało różne typy danych.

Wywołaj interfejs API tworzenia ACZ

Użyj interfejsu API ACZ Create, aby utworzyć instancję ACZ. Aby zapoznać się z pełnym przewodnikiem, zobacz Samouczek: używanie interfejsów API ACZ.

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

Zastąp symbole zastępcze

Pomyślna odpowiedź zwraca kod stanu HTTP 201 ze szczegółami ACZ:

{
  "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"
}

Zanotuj aczId wartość (format: acz-<identifier>). Ten identyfikator ACZ jest potrzebny do:

• Zarządzaj wystąpieniem ACZ i wysyłaj do niego zapytania za pomocą interfejsów API.
• Znajdź swoje dane w magazynie Data Lake Storage Gen2 w lokalizacji <container>/<aczId>/ lub <container>/<basePath>/<aczId>/, jeśli określono ścieżkę podstawową.

Treści powiązane

• Samouczek: korzystanie z interfejsów API ACZ
• Połącz dane ACZ do Microsoft Fabric
• Połącz dane ACZ do Azure Databricks
• Pojęcia strefy korzystania z analiz