Esta página descreve 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.
Criar um conjunto de dados
Os exemplos a seguir mostram como criar um conjunto de dados.
Permissões exigidas para a tarefa
Para executar esta tarefa, são necessárias as seguintes permissões ou os seguintes papéis de Gerenciamento de identidade e acesso (IAM):
Permissões
healthcare.datasets.create
Papéis
Você pode pedir ao administrador para conceder esses papéis de gerenciamento de identidade e acesso. Para instruções sobre como conceder papéis, consulte Gerenciar acesso ou Controlar o acesso aos recursos da API Cloud Healthcare. Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.
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 aos requisitos de tamanho e caracteres permitidos.
Selecione um dos seguintes tipos de local:
Region. O conjunto de dados fica permanentemente em uma região Google Cloud . Depois de selecionar essa opção, digite ou selecione um local no campo Região.
Multirregional. O conjunto de dados fica permanentemente em um local que abrange várias Google Cloud regiões. Depois de selecionar essa opção, digite ou selecione um local multirregional no campo Multirregião.
Clique em Criar. A página Navegador é exibida. O novo conjunto de dados será exibido na lista.
Execute o comando gcloud healthcare datasets create
.
Antes de usar os dados do comando abaixo, faça estas substituições:
: um local com suporte para o conjunto de dadosLOCATION
: um identificador sujeito aos requisitos de tamanho e caracteres permitidos do conjunto de dadosDATASET_ID
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud healthcare datasets createDATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare datasets createDATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare datasets createDATASET_ID ^ --location=LOCATION
Você receberá uma resposta semelhante a esta
Create request issued for: [DATASET_ID ] Created dataset [DATASET_ID ].
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:
: o ID do projeto Google CloudPROJECT_ID
: um local com suporte para o conjunto de dadosLOCATION
: um identificador sujeito aos requisitos de tamanho e caracteres permitidos do conjunto de dadosDATASET_ID
Para enviar a solicitação, escolha uma destas opções:
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 "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 ContentAbra 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.Resposta
{ "name": "projects/
PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /operations/OPERATION_ID " }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:
: o ID do projeto Google CloudPROJECT_ID
: o local do conjunto de dados;LOCATION
: o ID do conjunto de dados;DATASET_ID
: o ID retornado da operação de longa duração.OPERATION_ID
Para enviar a solicitação, escolha uma destas opções:
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 "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 ContentAbra 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 foi concluída.Resposta
{ "name": "projects/
PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /operations/OPERATION_ID ", "metadata": { "@type": "type.googleapis.com/google.cloud.healthcare.v1.OperationMetadata", "apiMethodName": "google.cloud.healthcare.v1.dataset.DatasetService.CreateDataset", "createTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ ", "endTime": "YYYY-MM-DDTHH:MM:SS+ZZ:ZZ ", "logsUrl": "https://console.cloud.google.com/CLOUD_LOGGING_URL " "counter": { "success": "SUCCESS_COUNT ", // If there were any failures, they display in the `failure` field. "failure": "FAILURE_COUNT " } }, "done": true, // The `response` field only displays if there were no errors. "response": { "@type": "type.googleapis.com/google.cloud.healthcare.v1.dataset.Dataset", "name": "PROJECT_ID /locations/LOCATION /datasets/DATASET_ID ", }, // If there were any errors, an `error` field displays instead of a `response` field. // See Troubleshooting long-running operations for a list of response codes. "error": { "code":ERROR_CODE , "message": "DESCRIPTION ", "details": [ { "@type": "...",FIELD1 : ..., ... } ] } }
Editar um conjunto de dados
Os exemplos a seguir mostram como editar um conjunto de dados.
Permissões exigidas para a tarefa
Para executar esta tarefa, são necessárias as seguintes permissões ou os seguintes papéis de Gerenciamento de identidade e acesso (IAM):
Permissões
healthcare.datasets.update
Papéis
Você pode pedir ao administrador para conceder esses papéis de gerenciamento de identidade e acesso. Para instruções sobre como conceder papéis, consulte Gerenciar acesso ou Controlar o acesso aos recursos da API Cloud Healthcare. Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.
O console do Google Cloud não é compatível com a edição de um conjunto de dados. Em vez disso, use a CLI do Google Cloud ou a API REST.
Execute o comando gcloud healthcare datasets update
.
Antes de usar os dados do comando abaixo, faça estas substituições:
: o local do conjunto de dados;LOCATION
: o ID do conjunto de dados;DATASET_ID
: um fuso horário com suporte, comoTIME_ZONE UTC
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud healthcare datasets updateDATASET_ID \ --location=LOCATION \ --time-zone=TIME_ZONE
Windows (PowerShell)
gcloud healthcare datasets updateDATASET_ID ` --location=LOCATION ` --time-zone=TIME_ZONE
Windows (cmd.exe)
gcloud healthcare datasets updateDATASET_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
Use o método projects.locations.datasets.patch
.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
: o ID do projeto Google CloudPROJECT_ID
: o local do conjunto de dados;LOCATION
: o ID do conjunto de dados;DATASET_ID
: um fuso horário com suporte, comoTIME_ZONE UTC
Corpo JSON da solicitação:
{ "timeZone": "TIME_ZONE " }
Para enviar a solicitação, escolha uma destas opções:
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"
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
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:
Resposta
{ "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID " "timeZone": "TIME_ZONE " }
Receber detalhes do conjunto de dados
Os exemplos a seguir mostram como receber detalhes sobre um conjunto de dados.
Permissões exigidas para a tarefa
Para executar esta tarefa, são necessárias as seguintes permissões ou os seguintes papéis de Gerenciamento de identidade e acesso (IAM):
Permissões
healthcare.datasets.get
Papéis
-
Leitor do conjunto de dados do Healthcare
(
roles/healthcare.datasetViewer
) -
Administrador de conjuntos de dados do Healthcare
(
roles/healthcare.datasetAdmin
)
Você pode pedir ao administrador para conceder esses papéis de gerenciamento de identidade e acesso. Para instruções sobre como conceder papéis, consulte Gerenciar acesso ou Controlar o acesso aos recursos da API Cloud Healthcare. Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.
No console do 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 de dados são exibidos.
Execute o
comando gcloud healthcare datasets describe
.
Antes de usar os dados do comando abaixo, faça estas substituições:
: o local do conjunto de dados;LOCATION
: o ID do conjunto de dados;DATASET_ID
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud healthcare datasets describeDATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare datasets describeDATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare datasets describeDATASET_ID ^ --location=LOCATION
Você receberá uma resposta semelhante a esta
name: projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID timeZone:TIME_ZONE
Use o método projects.locations.datasets.get
.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
: o ID do projeto Google CloudPROJECT_ID
: o local do conjunto de dados;LOCATION
: o ID do conjunto de dados;DATASET_ID
Para enviar a solicitação, escolha uma destas opções:
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 "
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
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:
Resposta
{ "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID " "timeZone": "TIME_ZONE " }
Listar conjuntos de dados
Os exemplos a seguir mostram como listar os conjuntos de dados no seu projeto.
Permissões exigidas para a tarefa
Para executar esta tarefa, são necessárias as seguintes permissões ou os seguintes papéis de Gerenciamento de identidade e acesso (IAM):
Permissões
healthcare.datasets.list
Papéis
-
Leitor do conjunto de dados do Healthcare
(
roles/healthcare.datasetViewer
) -
Administrador de conjuntos de dados do Healthcare
(
roles/healthcare.datasetAdmin
)
Você pode pedir ao administrador para conceder esses papéis de gerenciamento de identidade e acesso. Para instruções sobre como conceder papéis, consulte Gerenciar acesso ou Controlar o acesso aos recursos da API Cloud Healthcare. Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.
No console do Google Cloud, acesse a página Navegador.
Execute o
comando gcloud healthcare datasets list
.
Antes de usar os dados do comando abaixo, faça estas substituições:
: o local do conjunto de dados;LOCATION
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 TIMEZONEDATASET_ID LOCATION TIME_ZONE
Use o método projects.locations.datasets.list
.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
: o ID do projeto Google CloudPROJECT_ID
: o local do conjunto de dados;LOCATION
Para enviar a solicitação, escolha uma destas opções:
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"
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
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:
Resposta
{ "datasets": [ { "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID ", "timeZone": "TIME_ZONE " }, { ... } ] }
Excluir um conjunto de dados
Os exemplos a seguir mostram como excluir um conjunto de dados.
Permissões exigidas para a tarefa
Para executar esta tarefa, são necessárias as seguintes permissões ou os seguintes papéis de Gerenciamento de identidade e acesso (IAM):
Permissões
healthcare.datasets.delete
Papéis
Você pode pedir ao administrador para conceder esses papéis de gerenciamento de identidade e acesso. Para instruções sobre como conceder papéis, consulte Gerenciar acesso ou Controlar o acesso aos recursos da API Cloud Healthcare. Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.
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.
Execute o
comando gcloud healthcare datasets delete
.
Antes de usar os dados do comando abaixo, faça estas substituições:
: o local do conjunto de dados;LOCATION
: o ID do conjunto de dados;DATASET_ID
Execute o seguinte comando:
Linux, macOS ou Cloud Shell
gcloud healthcare datasets deleteDATASET_ID \ --location=LOCATION
Windows (PowerShell)
gcloud healthcare datasets deleteDATASET_ID ` --location=LOCATION
Windows (cmd.exe)
gcloud healthcare datasets deleteDATASET_ID ^ --location=LOCATION
Para confirmar, digite Y.
A saída é esta:
Deleted dataset [DATASET_ID ]
Use o método projects.locations.datasets.delete
.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
: o ID do projeto Google CloudPROJECT_ID
: o local do conjunto de dados;LOCATION
: o ID do conjunto de dados;DATASET_ID
Para enviar a solicitação, escolha uma destas opções:
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 "
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
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.
A seguir
- Desidentificar dados confidenciais
- Criar e gerenciar armazenamentos DICOM
- Criar e gerenciar armazenamentos FHIR
- Criar e gerenciar armazenamentos HL7v2