Nesta página, descrevemos como criar, editar, visualizar, listar e excluir conjuntos de dados. Depois de criar um conjunto de dados, você pode criar armazenamentos de dados que armazenam históricos de saúde eletrônicos e dados de imagens médicas, desidentificar o conjunto de dados e muito mais.
Antes de começar
Consulte a API Cloud Healthcare Modelo de dados.
Criar um conjunto de dados
Os exemplos a seguir mostram como criar um conjunto de dados.
Console
No console do 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 ao requisitos de tamanho e caracteres permitidos do conjunto de dados.
Selecione um dos seguintes tipos de local:
Region. O conjunto de dados reside permanentemente em uma região do Google Cloud. Depois de selecionar essa opção, digite ou selecione um local no campo Região.
Multirregional. O conjunto de dados reside permanentemente em um local que abrange várias regiões do Google Cloud. Depois de selecionar essa opção, digite ou selecione um local multirregional no campo Multirregional.
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 dados.DATASET_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 projeto do Google Cloud;LOCATION
: um local compatível para o conjunto de dados.DATASET_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 o 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 projeto do Google Cloud;LOCATION
: 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 o 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
, o operação de longa duração foi 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 do Google Cloud não oferece suporte à 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 projeto do Google Cloud;LOCATION
: 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 o 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 conseguir detalhes sobre um conjunto de dados.
Console
No console do Google Cloud, acesse a página Navegador.
Selecione o conjunto de dados. A página Conjunto de dados e os repositórios de dados no conjunto de dados serã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 projeto do Google Cloud;LOCATION
: 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 o 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 em seu projeto.
Console
No console do 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 projeto do Google Cloud;LOCATION
: 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 o 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 do 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 projeto do Google Cloud;LOCATION
: 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 o 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