Partilhar via

Tutorial: Usar pontos de extremidade da API websocket DDMS do reservatório

Use APIs DDMS (Serviços de Gerenciamento de Dados de Domínio de Reservatório) no PowerShell para trabalhar com dados de reservatório em um recurso do Azure Data Manager for Energy.

Neste tutorial, você aprenderá a usar um ponto de extremidade de websocket DDMS do Reservoir para:

  • Crie o espaço de dados.
  • Obtenha o espaço de dados.
  • Ingerir um ficheiro EPC.
  • Aceda aos dados ingeridos.
  • Exclua o espaço de dados.

Para obter mais informações sobre DDMS, consulte Conceitos de DDMS.

Pré-requisitos

Configuração

  1. Para se conectar a um servidor remoto via WSS, você precisa de um cliente habilitado para ETP SSL. Faça o download de um cliente SSL pré-construído do registro de contêiner docker do OSDU GitLab.

    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. Siga Como gerar um token de autenticação para criar um token de autenticação válido. Esse token é usado para autenticar as chamadas para o servidor.

  3. Defina as seguintes variáveis:

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

Usando os pontos de extremidade websocket

  1. Crie o espaço de dados:

    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} --xdata "{\"viewers\":[\"data.default.viewers@<data_partition_name>.dataservices.energy\"],\"owners\":[\"data.default.owners@<data_partition_name>.dataservices.energy\"],\"legaltags\":\"<legal_tag_name>\",\"otherRelevantDataCountries\":[\"<country_code1\", \"country_code2\"]}"

  2. Obtenha o espaço de dados:

    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. Ingerir um ficheiro 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. Aceda aos dados ingeridos:

    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. Exclua o espaço de dados:

    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}

Conteúdos relacionados

  • Last updated on