Tutorial: usar pontos de extremidade da API WebSocket de DDMS de reservatório

Use APIs de 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 Gerenciador de Dados do Azure para Energia.

Neste tutorial, você aprenderá a usar um ponto de extremidade WebSocket de DDMS de reservatório para:

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

Pré-requisitos

• Recurso Gerenciador de Dados de Energia do Azure criado na sua assinatura do Azure
• O cliente da área de trabalho do Docker deve estar em execução em seu sistema

Configuração

1. Para se conectar a um servidor remoto por meio do WSS, é necessário ter um cliente habilitado para ETP SSL. Baixe um cliente SSL pré-criado do registro de contêiner do Docker do GitLab do OSDU.

   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>'
   

Como usar 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. Faça a ingestão de um arquivo do 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. Acesse os 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údo relacionado

• Como usar pontos de extremidade WebSocket de RDDMS
• Usar APIs de DDMS do reservatório