Halaman ini menjelaskan cara membuat, mengedit, melihat, mencantumkan, dan menghapus set data. Setelah membuat set data, Anda dapat membuat penyimpanan data yang menyimpan rekam medis elektronik dan data pencitraan medis, menghapus identitas set data, dan lainnya.
Sebelum memulai
Lihat Model data Cloud Healthcare API.
Membuat set data
Contoh berikut menunjukkan cara membuat set data.
Izin yang diperlukan untuk langkah ini
Untuk melakukan tugas ini, Anda harus sudah diberi izin berikut atau peran Identity and Access Management (IAM) berikut:
Izin
healthcare.datasets.create
Peran
Anda dapat meminta administrator untuk memberikan peran Identity and Access Management ini kepada Anda. Untuk mengetahui petunjuk tentang cara memberikan peran, lihat Mengelola akses atau Mengontrol akses ke resource Cloud Healthcare API. Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Di konsol Google Cloud, buka halaman Browser.
Klik add_box Buat set data. Halaman Dataset properties akan ditampilkan.
Di kolom Name, masukkan ID untuk set data yang tunduk pada persyaratan ukuran dan karakter yang diizinkan untuk set data.
Pilih salah satu jenis lokasi berikut:
Region. Set data berada secara permanen dalam satu Google Cloud region. Setelah memilih opsi ini, ketik atau pilih lokasi di kolom Region.
Multi-region. Set data berada secara permanen dalam lokasi yang mencakup beberapa region Google Cloud . Setelah memilih opsi ini, ketik atau pilih lokasi multi-region di kolom Multi-region.
Klik Buat. Halaman Browser akan ditampilkan. Set data baru akan ditampilkan dalam daftar set data.
Jalankan perintah gcloud healthcare datasets create
.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
: Lokasi yang didukung untuk set dataLOCATION
: ID yang tunduk pada persyaratan ukuran dan karakter yang diizinkan set dataDATASET_ID
Jalankan perintah berikut:
Linux, macOS, atau 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
Anda akan melihat respons seperti berikut:
Create request issued for: [DATASET_ID ] Created dataset [DATASET_ID ].
Buat set data menggunakan metode
projects.locations.datasets.create
.Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
: ID Google Cloud project AndaPROJECT_ID
: lokasi yang didukung untuk set dataLOCATION
: ID yang tunduk pada persyaratan ukuran dan karakter yang diizinkan set dataDATASET_ID
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
Jalankan perintah berikut:
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 "Jalankan perintah berikut:
$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 ContentBuka halaman referensi metode. Panel API Explorer terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Lengkapi kolom yang wajib diisi, lalu klik Jalankan.
OPERATION_ID
. Anda memerlukan nilai ini di langkah berikutnya.Respons
{ "name": "projects/
PROJECT_ID /locations/LOCATION /datasets/DATASET_ID /operations/OPERATION_ID " }Dapatkan status operasi yang berjalan lama menggunakan metode
projects.locations.datasets.operations.get
.Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
: ID Google Cloud project AndaPROJECT_ID
: lokasi set dataLOCATION
: ID set dataDATASET_ID
: ID yang ditampilkan dari operasi yang berjalan lamaOPERATION_ID
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
Jalankan perintah berikut:
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 "Jalankan perintah berikut:
$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 ContentBuka halaman referensi metode. Panel API Explorer terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Lengkapi kolom yang wajib diisi, lalu klik Jalankan.
"done": true
, operasi yang berjalan lama telah selesai.Respons
{ "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 : ..., ... } ] } }
Mengedit set data
Contoh berikut menunjukkan cara mengedit set data.
Izin yang diperlukan untuk langkah ini
Untuk melakukan tugas ini, Anda harus sudah diberi izin berikut atau peran Identity and Access Management (IAM) berikut:
Izin
healthcare.datasets.update
Peran
Anda dapat meminta administrator untuk memberikan peran Identity and Access Management ini kepada Anda. Untuk mengetahui petunjuk tentang cara memberikan peran, lihat Mengelola akses atau Mengontrol akses ke resource Cloud Healthcare API. Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Konsol Google Cloud tidak mendukung pengeditan set data. Sebagai gantinya, gunakan Google Cloud CLI atau REST API.
Jalankan perintah gcloud healthcare datasets update
.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
: lokasi set dataLOCATION
: ID set dataDATASET_ID
: zona waktu yang didukung, sepertiTIME_ZONE UTC
Jalankan perintah berikut:
Linux, macOS, atau 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
Anda akan melihat respons seperti berikut:
Updated dataset [DATASET_ID ]. name: projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID timeZone:TIME_ZONE
Gunakan metode projects.locations.datasets.patch
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
: ID Google Cloud project AndaPROJECT_ID
: lokasi set dataLOCATION
: ID set dataDATASET_ID
: zona waktu yang didukung, sepertiTIME_ZONE UTC
Meminta isi JSON:
{ "timeZone": "TIME_ZONE " }
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
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"
Simpan isi permintaan dalam file bernama request.json
,
dan jalankan perintah berikut:
$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
Salin isi permintaan dan buka halaman referensi metode. Panel API Explorer terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Tempelkan isi permintaan di alat ini, lengkapi kolom lainnya yang wajib diisi, lalu klik Jalankan.
Anda akan melihat respons JSON seperti berikut:
Respons
{ "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID " "timeZone": "TIME_ZONE " }
Mendapatkan detail set data
Contoh berikut menunjukkan cara mendapatkan detail tentang set data.
Izin yang diperlukan untuk langkah ini
Untuk melakukan tugas ini, Anda harus sudah diberi izin berikut atau peran Identity and Access Management (IAM) berikut:
Izin
healthcare.datasets.get
Peran
-
Healthcare Dataset Viewer
(
roles/healthcare.datasetViewer
) -
Healthcare Dataset Administrator
(
roles/healthcare.datasetAdmin
)
Anda dapat meminta administrator untuk memberikan peran Identity and Access Management ini kepada Anda. Untuk mengetahui petunjuk tentang cara memberikan peran, lihat Mengelola akses atau Mengontrol akses ke resource Cloud Healthcare API. Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Di konsol Google Cloud, buka halaman Browser.
Pilih set data. Halaman Dataset dan penyimpanan data dalam set data akan ditampilkan.
Jalankan perintah
gcloud healthcare datasets describe
.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
: lokasi set dataLOCATION
: ID set dataDATASET_ID
Jalankan perintah berikut:
Linux, macOS, atau 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
Anda akan melihat respons seperti berikut:
name: projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID timeZone:TIME_ZONE
Gunakan metode projects.locations.datasets.get
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
: ID Google Cloud project AndaPROJECT_ID
: lokasi set dataLOCATION
: ID set dataDATASET_ID
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID "
Jalankan perintah berikut:
$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
Buka halaman referensi metode. Panel API Explorer terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Lengkapi kolom yang wajib diisi, lalu klik Jalankan.
Anda akan melihat respons JSON seperti berikut:
Respons
{ "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID " "timeZone": "TIME_ZONE " }
Mencantumkan set data
Contoh berikut menunjukkan cara mencantumkan set data dalam project Anda.
Izin yang diperlukan untuk langkah ini
Untuk melakukan tugas ini, Anda harus sudah diberi izin berikut atau peran Identity and Access Management (IAM) berikut:
Izin
healthcare.datasets.list
Peran
-
Healthcare Dataset Viewer
(
roles/healthcare.datasetViewer
) -
Administrator Set Data Kesehatan
(
roles/healthcare.datasetAdmin
)
Anda dapat meminta administrator untuk memberikan peran Identity and Access Management ini kepada Anda. Untuk mengetahui petunjuk tentang cara memberikan peran, lihat Mengelola akses atau Mengontrol akses ke resource Cloud Healthcare API. Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Di konsol Google Cloud, buka halaman Browser.
Jalankan perintah
gcloud healthcare datasets list
.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
: lokasi set dataLOCATION
Jalankan perintah berikut:
Linux, macOS, atau 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
Anda akan melihat respons seperti berikut:
ID LOCATION TIMEZONEDATASET_ID LOCATION TIME_ZONE
Gunakan metode projects.locations.datasets.list
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
: ID Google Cloud project AndaPROJECT_ID
: lokasi set dataLOCATION
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
Jalankan perintah berikut:
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets"
Jalankan perintah berikut:
$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
Buka halaman referensi metode. Panel API Explorer terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Lengkapi kolom yang wajib diisi, lalu klik Jalankan.
Anda akan melihat respons JSON seperti berikut:
Respons
{ "datasets": [ { "name": "projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID ", "timeZone": "TIME_ZONE " }, { ... } ] }
Menghapus set data
Contoh berikut menunjukkan cara menghapus set data.
Izin yang diperlukan untuk langkah ini
Untuk melakukan tugas ini, Anda harus sudah diberi izin berikut atau peran Identity and Access Management (IAM) berikut:
Izin
healthcare.datasets.delete
Peran
Anda dapat meminta administrator untuk memberikan peran Identity and Access Management ini kepada Anda. Untuk mengetahui petunjuk tentang cara memberikan peran, lihat Mengelola akses atau Mengontrol akses ke resource Cloud Healthcare API. Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
Di konsol Google Cloud, buka halaman Browser.
Di baris yang sama dengan set data, klik opsi Actions
, lalu pilih Delete.Pada dialog konfirmasi, masukkan ID set data, lalu klik Delete.
Jalankan perintah
gcloud healthcare datasets delete
.
Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:
: lokasi set dataLOCATION
: ID set dataDATASET_ID
Jalankan perintah berikut:
Linux, macOS, atau 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
Untuk mengonfirmasi, ketik Y.
Outputnya adalah sebagai berikut:
Deleted dataset [DATASET_ID ]
Gunakan metode projects.locations.datasets.delete
.
Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:
: ID Google Cloud project AndaPROJECT_ID
: lokasi set dataLOCATION
: ID set dataDATASET_ID
Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:
Jalankan perintah berikut:
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://healthcare.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /datasets/DATASET_ID "
Jalankan perintah berikut:
$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
Buka halaman referensi metode. Panel API Explorer terbuka di sisi kanan halaman. Anda bisa berinteraksi dengan alat ini untuk mengirim permintaan. Lengkapi kolom yang wajib diisi, lalu klik Jalankan.
Anda akan menerima kode status yang menandakan proses berhasil (2xx), dan sebuah respons kosong.
Langkah selanjutnya
- Melakukan de-identifikasi data sensitif
- Membuat dan mengelola penyimpanan DICOM
- Membuat dan mengelola penyimpanan FHIR
- Membuat dan mengelola penyimpanan HL7v2