Auf dieser Seite wird beschrieben, wie Sie Datasets erstellen, bearbeiten, anzeigen, auflisten und löschen. Nachdem Sie ein Dataset erstellt haben, können Sie Datenspeicher erstellen, die elektronische Gesundheitsdaten und medizinische Bildgebungsdaten enthalten, das Dataset de-identifizieren und vieles mehr.
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-Attribute wird angezeigt.
Geben Sie im Feld Name eine Kennzeichnung für das Dataset ein, die den zulässigen Zeichen und Größenanforderungen für Datasets entspricht.
Wählen Sie einen der folgenden Standorttypen aus:
Region Das Dataset befindet sich dauerhaft in einer Google Cloud-Region. Nachdem Sie diese Option ausgewählt haben, geben oder wählen Sie einen Ort in das Feld Region aus.
Mehrere Regionen: Das Dataset befindet sich dauerhaft an einem Standort, der sich über mehrere Google Cloud-Regionen erstreckt. Nachdem Sie diese Option ausgewählt haben, geben oder wählen Sie einen multiregionalen Standort in das Feld Multi-region (Mehrere Regionen) ein.
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.
Bevor Sie die folgenden Befehlsdaten verwenden, ersetzen Sie die folgenden Werte:
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 den 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
.Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
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
Senden Sie die Anfrage mithilfe einer der folgenden Optionen:
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 folgenden 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 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üllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
OPERATION_ID
. Sie benötigen diesen Wert im nächsten Schritt.Rufen Sie den Status des lang andauernden Vorgangs mit der Methode
projects.locations.datasets.operations.get
ab.Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
PROJECT_ID
ist die ID Ihres Google Cloud-ProjektsLOCATION
ist der Standort des DatasetsDATASET_ID
ist die Dataset-IDOPERATION_ID
ist die ID, die vom lang andauernden Vorgang 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 folgenden 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 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ü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 ein Dataset bearbeitet wird.
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.
Bevor Sie die folgenden Befehlsdaten verwenden, ersetzen Sie die folgenden Werte:
LOCATION
ist der Standort des DatasetsDATASET_ID
ist die Dataset-IDTIME_ZONE
ist eine unterstützte Zeitzone, z. B.UTC
Führen Sie den 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
.
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
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 anfordern:
{ "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 in etwa folgende JSON-Antwort 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.
Bevor Sie die folgenden Befehlsdaten verwenden, ersetzen Sie die folgenden Werte:
LOCATION
ist der Standort des DatasetsDATASET_ID
ist die Dataset-ID
Führen Sie den 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
.
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
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 folgenden 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 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üllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten in etwa folgende JSON-Antwort 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.
Bevor Sie die folgenden Befehlsdaten verwenden, ersetzen Sie die folgenden Werte:
LOCATION
ist der Standort des Datasets
Führen Sie den 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
.
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
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 folgenden 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 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üllen Sie die Pflichtfelder aus und klicken Sie auf Ausführen.
Sie sollten in etwa folgende JSON-Antwort 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 der Zeile, in der sich auch das Dataset befindet, auf die Option
Aktionen und wählen Sie dann Löschen aus.Geben Sie im Bestätigungsdialogfeld die Dataset-ID ein und klicken Sie dann auf Löschen.
gcloud
Führen Sie den Befehl gcloud healthcare datasets delete
aus.
Bevor Sie die folgenden Befehlsdaten verwenden, ersetzen Sie die folgenden Werte:
LOCATION
ist der Standort des DatasetsDATASET_ID
ist die Dataset-ID
Führen Sie den 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
.
Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:
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 folgenden 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 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ü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