Nesta página, explicamos como criar, editar, visualizar, listar e excluir conjuntos de dados. Depois disso, crie armazenamentos de dados com registros eletrônicos de saúde e dados de imagens médicas, remova a identificação do conjunto de dados e muito mais.
Antes de começar
Consulte o modelo de dados da API Cloud Healthcare.
crie um conjunto de dados
Os exemplos a seguir mostram como criar um conjunto de dados.
Console
No console Google Cloud , acesse a página Navegador.
Clique em add_box Criar conjunto de dados. A página Propriedades do conjunto de dados é exibida.
No campo Nome, insira um identificador para o conjunto de dados sujeito aos requisitos de tamanho e caracteres permitidos do conjunto de dados.
Selecione um dos seguintes tipos de local:
Region. O conjunto de dados fica permanentemente em uma Google Cloud região. Depois de selecionar essa opção, digite ou escolha um local no campo Região.
Multirregional. O conjunto de dados reside permanentemente em um local que abrange várias regiões Google Cloud . Depois de selecionar essa opção, digite ou escolha um local multirregional no campo Multirregião.
Clique em Criar. A página Navegador é exibida. O novo conjunto de dados será exibido na lista.
gcloud
Execute o comando gcloud healthcare datasets create
.
Antes de usar os dados do comando abaixo, faça estas substituições:
LOCATION
: um local compatível para o conjunto de dadosDATASET_ID
: um identificador sujeito aos requisitos de tamanho e caracteres permitidos do conjunto de dados
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud healthcare datasets create DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare datasets create DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare datasets create DATASET_ID ^ --location=LOCATION
Você receberá uma resposta semelhante a esta
Create request issued for: [DATASET_ID] Created dataset [DATASET_ID].
REST
Crie o conjunto de dados usando o método
projects.locations.datasets.create
.Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID
: o ID do seu Google Cloud projetoLOCATION
: um local compatível para o conjunto de dadosDATASET_ID
: um identificador sujeito aos requisitos de tamanho e caracteres permitidos do conjunto de dados
Para enviar a solicitação, escolha uma destas opções:
curl
execute o seguinte comando:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?datasetId=DATASET_ID"PowerShell
Execute o seguinte comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets?datasetId=DATASET_ID" | Select-Object -Expand ContentAPIs Explorer
Abra a página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Preencha todos os campos obrigatórios e clique em Executar.
OPERATION_ID
. Você vai precisar desse valor na próxima etapa.Confira o status da operação de longa duração usando o método
projects.locations.datasets.operations.get
.Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID
: o ID do seu Google Cloud projetoLOCATION
: o local do conjunto de dados;DATASET_ID
: o ID do conjunto de dados;OPERATION_ID
: o ID retornado da operação de longa duração.
Para enviar a solicitação, escolha uma destas opções:
curl
execute o seguinte comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID"PowerShell
Execute o seguinte comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/operations/OPERATION_ID" | Select-Object -Expand ContentAPIs Explorer
Abra a página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Preencha todos os campos obrigatórios e clique em Executar.
"done": true
, a operação de longa duração é concluída.
Go
Java
Node.js
Python
Editar um conjunto de dados
Os exemplos a seguir mostram como editar um conjunto de dados.
Console
O console Google Cloud não é compatível com a edição de um conjunto de dados. Em vez disso, use a Google Cloud CLI ou a API REST.
gcloud
Execute o comando gcloud healthcare datasets update
.
Antes de usar os dados do comando abaixo, faça estas substituições:
LOCATION
: o local do conjunto de dados;DATASET_ID
: o ID do conjunto de dados;TIME_ZONE
: um fuso horário compatível, comoUTC
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud healthcare datasets update DATASET_ID \ --location=LOCATION \ --time-zone=TIME_ZONE
Windows (PowerShell)
gcloud healthcare datasets update DATASET_ID ` --location=LOCATION ` --time-zone=TIME_ZONE
Windows (cmd.exe)
gcloud healthcare datasets update DATASET_ID ^ --location=LOCATION ^ --time-zone=TIME_ZONE
Você receberá uma resposta semelhante a esta
Updated dataset [DATASET_ID]. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
REST
Use o método projects.locations.datasets.patch
.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID
: o ID do seu Google Cloud projetoLOCATION
: o local do conjunto de dados;DATASET_ID
: o ID do conjunto de dados;TIME_ZONE
: um fuso horário compatível, comoUTC
Corpo JSON da solicitação:
{ "timeZone": "TIME_ZONE" }
Para enviar a solicitação, escolha uma destas opções:
curl
Salve o corpo da solicitação em um arquivo com o nome request.json
e execute o comando a seguir:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID?updateMask=timeZone"
PowerShell
Salve o corpo da solicitação em um arquivo com o nome request.json
e execute o comando a seguir:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID?updateMask=timeZone" | Select-Object -Expand Content
APIs Explorer
Copie o corpo da solicitação e abra a página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Cole o corpo da solicitação nessa ferramenta, preencha todos os outros campos obrigatórios e clique em Executar.
Você receberá uma resposta JSON semelhante a esta:
Go
Java
Node.js
Python
Receber detalhes do conjunto de dados
Os exemplos a seguir mostram como receber detalhes sobre um conjunto de dados.
Console
No console Google Cloud , acesse a página Navegador.
Selecione o conjunto de dados. A página Conjunto de dados e os armazenamentos de dados no conjunto são exibidos.
gcloud
Execute o
comando gcloud healthcare datasets describe
.
Antes de usar os dados do comando abaixo, faça estas substituições:
LOCATION
: o local do conjunto de dados;DATASET_ID
: o ID do conjunto de dados;
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud healthcare datasets describe DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare datasets describe DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare datasets describe DATASET_ID ^ --location=LOCATION
Você receberá uma resposta semelhante a esta
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
REST
Use o método projects.locations.datasets.get
.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID
: o ID do seu Google Cloud projetoLOCATION
: o local do conjunto de dados;DATASET_ID
: o ID do conjunto de dados;
Para enviar a solicitação, escolha uma destas opções:
curl
execute o seguinte comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID"
PowerShell
Execute o seguinte comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID" | Select-Object -Expand Content
APIs Explorer
Abra a página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Preencha todos os campos obrigatórios e clique em Executar.
Você receberá uma resposta JSON semelhante a esta:
Go
Java
Node.js
Python
Listar conjuntos de dados
Os exemplos a seguir mostram como listar os conjuntos de dados no seu projeto.
Console
No console Google Cloud , acesse a página Navegador.
gcloud
Execute o
comando gcloud healthcare datasets list
.
Antes de usar os dados do comando abaixo, faça estas substituições:
LOCATION
: o local do conjunto de dados;
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud healthcare datasets list --location=LOCATION
Windows (PowerShell)
gcloud healthcare datasets list --location=LOCATION
Windows (cmd.exe)
gcloud healthcare datasets list --location=LOCATION
Você receberá uma resposta semelhante a esta
ID LOCATION TIMEZONE DATASET_ID LOCATION TIME_ZONE
REST
Use o método projects.locations.datasets.list
.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID
: o ID do seu Google Cloud projetoLOCATION
: o local do conjunto de dados;
Para enviar a solicitação, escolha uma destas opções:
curl
execute o seguinte comando:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets"
PowerShell
Execute o seguinte comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets" | Select-Object -Expand Content
APIs Explorer
Abra a página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Preencha todos os campos obrigatórios e clique em Executar.
Você receberá uma resposta JSON semelhante a esta:
Go
Java
Node.js
Python
Excluir um conjunto de dados
Os exemplos a seguir mostram como excluir um conjunto de dados.
Console
No console Google Cloud , acesse a página Navegador.
Na mesma linha do conjunto de dados, clique na opção
Ações e selecione Excluir.Na caixa de diálogo de confirmação, insira o ID do conjunto de dados e clique em Excluir.
gcloud
Execute o
comando gcloud healthcare datasets delete
.
Antes de usar os dados do comando abaixo, faça estas substituições:
LOCATION
: o local do conjunto de dados;DATASET_ID
: o ID do conjunto de dados;
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud healthcare datasets delete DATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare datasets delete DATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare datasets delete DATASET_ID ^ --location=LOCATION
Para confirmar, digite Y.
A saída é esta:
Deleted dataset [DATASET_ID]
REST
Use o método projects.locations.datasets.delete
.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
PROJECT_ID
: o ID do seu Google Cloud projetoLOCATION
: o local do conjunto de dados;DATASET_ID
: o ID do conjunto de dados;
Para enviar a solicitação, escolha uma destas opções:
curl
execute o seguinte comando:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID"
PowerShell
Execute o seguinte comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID" | Select-Object -Expand Content
APIs Explorer
Abra a página de referência do método. O painel "APIs Explorer" é aberto no lado direito da página. Interaja com essa ferramenta para enviar solicitações. Preencha todos os campos obrigatórios e clique em Executar.
Você receberá um código de status bem-sucedido (2xx) e uma resposta vazia.
Go
Java
Node.js
Python
A seguir
- Desidentificar dados confidenciais
- Criar e gerenciar armazenamentos DICOM
- Criar e gerenciar armazenamentos FHIR
- Criar e gerenciar armazenamentos HL7v2