Sdílet prostřednictvím

Kurz: Použití koncových bodů rozhraní API websocketu DDMS

  • Článek

K práci s daty nádrží v Azure Data Manageru pro energetické zdroje použijte rozhraní API služby Domain Správa dat Services (DDMS) v PowerShellu.

V tomto kurzu se dozvíte, jak pomocí koncového bodu websocket DDMS použít zásobník DDMS k:

  • Vytvořte datový prostor.
  • Získejte datový prostor.
  • Ingestování souboru EPC.
  • Získejte přístup k přijatým datům.
  • Odstraňte datový prostor.

Další informace o DDMS najdete v tématu Koncepty DDMS.

Požadavky

Konfigurace

  1. Pokud se chcete připojit ke vzdálenému serveru přes WSS, potřebujete klienta s povoleným protokolem SSL protokolu ETP. Stáhněte si předem připraveného klienta SSL z registru kontejneru Dockeru OSDU GitLabu.

    export SSLCLIENT_IMAGE=community.opengroup.org:5555/osdu/platform/domain-data-mgmt-services/reservoir/open-etp-server/open-etp-sslclient-main
docker pull ${SSLCLIENT_IMAGE}
docker tag ${SSLCLIENT_IMAGE} open-etp:ssl-client

  2. Postupujte podle postupu vygenerování ověřovacího tokenu a vytvořte platný ověřovací token. Tento token slouží k ověření volání serveru.

  3. Nastavte následující proměnné:

    $RDDMS_URL='<adme_dns>/api/reservoir-ddms-etp/v2/'
$PARTITION='<data_partition_name>'
$TOKEN='<access_token>'

Použití koncových bodů protokolu websocket

  1. Vytvořte datový prostor:

    docker run -it --rm open-etp:ssl-client openETPServer space -S wss://${RDDMS_URL} --new -s <data_space_name> --data-partition-id ${PARTITION} --auth bearer --jwt-token ${TOKEN}

  2. Získání datového prostoru:

    docker run -it --rm open-etp:ssl-client openETPServer space -S wss://${RDDMS_URL} -l --data-partition-id ${PARTITION} --auth bearer --jwt-token ${TOKEN}

  3. Ingestování souboru EPC:

    docker run -it --rm -v <path_to_directory_containing_epc_file>:/data open-etp:ssl-client openETPServer space -S wss://${RDDMS_URL} -s <dataspace_name> --import-epc ./data/<epc_file_name> --data-partition-id ${PARTITION} --auth bearer --jwt-token ${TOKEN}

  4. Přístup k přijatým datům:

    docker run -it --rm open-etp:ssl-client openETPServer space -S wss://${RDDMS_URL} -s <dataspace_name> --stats --data-partition-id ${PARTITION} --auth bearer --jwt-token ${TOKEN}

  5. Odstraňte datový prostor:

    docker run -it --rm open-etp:ssl-client openETPServer space --delete -S wss://${RDDMS_URL} -s <dataspace_name> --data-partition-id ${PARTITION} --auth bearer --jwt-token ${TOKEN}

Související obsah