Auf dieser Seite wird beschrieben, wie Sie Datasets erstellen, bearbeiten, auflisten, anzeigen und löschen. Nachdem Sie ein Dataset erstellt haben, können Sie unter anderem Datenspeicher erstellen, die elektronische Gesundheitsdaten und medizinische Bildgebungsdaten enthalten, und die Dataset-Identität entfernen.
Hinweise
Weitere Informationen finden Sie im Datenmodell der Cloud Healthcare API.
Dataset erstellen
Die folgenden Beispiele zeigen, wie Sie ein Dataset erstellen können.
Console
Rufen Sie in der Google Cloud Console die Seite Browser auf.
Klicken Sie auf add_box Dataset erstellen. Die Seite Dataset-Eigenschaften wird angezeigt.
Geben Sie im Feld Name eine Kennzeichnung für das Dataset ein. Beachten Sie dabei die Anforderungen an Zeichen und Größen.
Wählen Sie einen der folgenden Standorttypen aus:
Region Das Dataset befindet sich dauerhaft in einer Google Cloud-Region. Geben Sie nach der Auswahl dieser Option einen Standort in das Feld Region ein oder wählen Sie ihn aus.
Mehrere Regionen Das Dataset befindet sich dauerhaft an einem Standort, der mehrere Google Cloud-Regionen umfasst. Geben Sie nach der Auswahl dieser Option einen multiregionalen Standort in das Feld Mehrere Regionen ein oder wählen Sie ihn aus.
Klicken Sie auf Erstellen. Die Seite Browser wird angezeigt. Das neue Dataset wird in der Liste der Datasets angezeigt.
gcloud
Führen Sie den Befehl gcloud healthcare datasets create
aus.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
LOCATION
: ein unterstützter Standort für das DatasetDATASET_ID
: Eine Kennung, die den zulässigen Zeichen und Größenanforderungen für Datasets unterliegt.
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Create request issued for: [DATASET_ID] Created dataset [DATASET_ID].
REST
Erstellen Sie das Dataset mit der Methode
projects.locations.datasets.create
.Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist die ID Ihres Google Cloud-ProjektsLOCATION
: ein unterstützter Standort für das DatasetDATASET_ID
: Eine Kennung, die den zulässigen Zeichen und Größenanforderungen für Datasets unterliegt.
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
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
Führen Sie diesen Befehl aus:
$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
Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
OPERATION_ID
. Sie benötigen diesen Wert im nächsten Schritt.Mit der Methode
projects.locations.datasets.operations.get
können Sie den Status des Vorgangs mit langer Ausführungszeit abrufen.Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des DatasetsDATASET_ID
ist die Dataset-IDOPERATION_ID
: die ID, die vom Vorgang mit langer Ausführungszeit zurückgegeben wurde
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
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
Führen Sie diesen Befehl aus:
$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
Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
"done": true
enthält, ist der lang andauernde Vorgang abgeschlossen.
Go
Java
Node.js
Python
Dataset bearbeiten
Die folgenden Beispiele zeigen, wie Sie ein Dataset bearbeiten.
Console
Die Google Cloud Console unterstützt das Bearbeiten eines Datasets nicht. Verwenden Sie stattdessen die Google Cloud CLI oder die REST API.
gcloud
Führen Sie den Befehl gcloud healthcare datasets update
aus.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
LOCATION
ist der Standort des DatasetsDATASET_ID
ist die Dataset-IDTIME_ZONE
ist eine unterstützte Zeitzone, z. B.UTC
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Sie sollten eine Antwort ähnlich der folgenden erhalten:
Updated dataset [DATASET_ID]. name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
REST
Verwenden Sie die Methode projects.locations.datasets.patch
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des DatasetsDATASET_ID
ist die Dataset-IDTIME_ZONE
ist eine unterstützte Zeitzone, z. B.UTC
JSON-Text der Anfrage:
{ "timeZone": "TIME_ZONE" }
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
und führen Sie den folgenden Befehl aus:
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
Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json
und führen Sie den folgenden Befehl aus:
$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
Kopieren Sie den Anfragetext und öffnen Sie die Referenzseite für Methoden. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Fügen Sie den Anfragetext in dieses Tool ein, füllen Sie alle Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
Go
Java
Node.js
Python
Ruft Dataset-Details ab
Die folgenden Beispiele zeigen, wie Sie Details zu einem Dataset abrufen können.
Console
Rufen Sie in der Google Cloud Console die Seite Browser auf.
Wählen Sie das Dataset aus. Die Seite Dataset und die Datenspeicher im Dataset werden angezeigt.
gcloud
Führen Sie den Befehl gcloud healthcare datasets describe
aus.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
LOCATION
ist der Standort des DatasetsDATASET_ID
ist die Dataset-ID
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Sie sollten eine Antwort ähnlich der folgenden erhalten:
name: projects/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID timeZone: TIME_ZONE
REST
Verwenden Sie die Methode projects.locations.datasets.get
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des DatasetsDATASET_ID
ist die Dataset-ID
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
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
Führen Sie diesen Befehl aus:
$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
Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
Go
Java
Node.js
Python
Datasets auflisten
Die folgenden Beispiele zeigen, wie Sie die Datasets in Ihrem Projekt auflisten können.
Console
Rufen Sie in der Google Cloud Console die Seite Browser auf.
gcloud
Führen Sie den Befehl gcloud healthcare datasets list
aus.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
LOCATION
ist der Standort des Datasets
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Sie sollten eine Antwort ähnlich der folgenden erhalten:
ID LOCATION TIMEZONE DATASET_ID LOCATION TIME_ZONE
REST
Verwenden Sie die Methode projects.locations.datasets.list
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des Datasets
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/datasets"
PowerShell
Führen Sie diesen Befehl aus:
$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
Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
Go
Java
Node.js
Python
Dataset löschen
Die folgenden Beispiele zeigen, wie Sie ein Dataset löschen können.
Console
Rufen Sie in der Google Cloud Console die Seite Browser auf.
Klicken Sie in derselben Zeile wie das Dataset auf die Option
Aktionen und wählen Sie Löschen aus.Geben Sie im Bestätigungsdialogfeld die Dataset-ID ein und klicken Sie auf Löschen.
gcloud
Führen Sie den Befehl gcloud healthcare datasets delete
aus.
Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:
LOCATION
ist der Standort des DatasetsDATASET_ID
ist die Dataset-ID
Führen Sie folgenden Befehl aus:
Linux, macOS oder 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
Geben Sie zur Bestätigung Y ein.
Die Ausgabe sieht so aus:
Deleted dataset [DATASET_ID]
REST
Verwenden Sie die Methode projects.locations.datasets.delete
.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
PROJECT_ID
ist die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des DatasetsDATASET_ID
ist die Dataset-ID
Wenn Sie die Anfrage senden möchten, wählen Sie eine der folgenden Optionen aus:
curl
Führen Sie folgenden Befehl aus:
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
Führen Sie diesen Befehl aus:
$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
Öffnen Sie die Methodenreferenzseite. Der API Explorer wird rechts auf der Seite geöffnet. Sie können mit diesem Tool interagieren, um Anfragen zu senden. Füllen Sie die erforderlichen Felder aus und klicken Sie auf Ausführen.
Sie sollten einen erfolgreichen Statuscode (2xx) und eine leere Antwort als Ausgabe erhalten.
Go
Java
Node.js
Python
Nächste Schritte
- Identifizierung von sensiblen Daten aufheben
- DICOM-Speicher erstellen und verwalten
- FHIR-Speicher erstellen und verwalten
- HL7V2-Speicher erstellen und verwalten