瞭解實用的疑難排解步驟,協助您解決使用 Cloud Healthcare API 時遇到的問題。
無法啟用 Cloud Healthcare API
首次在Google Cloud 專案中啟用 Cloud Healthcare API 時,可能會遇到權限錯誤,指出您沒有權限為專案啟用 Google CloudAPI。
如要瞭解如何啟用 Google Cloud API (包括 Cloud Healthcare API),請參閱「啟用及停用 API」。
無法向 Cloud Healthcare API 進行驗證
呼叫 Cloud Healthcare API 時,您可能會收到錯誤訊息,指出「應用程式預設憑證」無法使用。
如要瞭解如何設定應用程式預設憑證,或如何手動將驗證憑證傳遞至應用程式或指令,請參閱「向 API 進行驗證」。
缺少 Cloud Healthcare API 服務帳戶或 Healthcare 服務代理角色
建立第一個資料集時,系統會自動建立 Cloud Healthcare 服務代理服務帳戶。這是 Google 代管的服務帳戶。您無法完全刪除服務帳戶,但在某些情況下,服務帳戶可能不會顯示在「Identity and Access Management」頁面中,而且您可能會遇到 Cloud Healthcare API 相關問題。
為確保 Cloud Healthcare API 正常運作,並完成發布及接收 Pub/Sub 訊息,或將指標寫入 Cloud Logging 等工作,Cloud Healthcare 服務代理服務帳戶必須存在,且須具備 Healthcare 服務代理 IAM 角色。
如果遇到下列任一問題,您可以手動建立 Cloud Healthcare 服務代理服務帳戶,或授予 Healthcare 服務代理 IAM 角色:
- 在「Identity and Access Management」頁面中,找不到 Cloud Healthcare 服務代理服務帳戶。
- 您可以找到 Cloud Healthcare 服務代理服務帳戶,但該帳戶不含 Healthcare 服務代理角色。
如要手動建立服務帳戶,請按照手動觸發建立作業中的指示操作。
使用 Google Cloud CLI,透過服務帳戶 ID (格式為 service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com) 將 healthcare.serviceAgent 角色新增至 Cloud Healthcare 服務代理服務帳戶。如要找出 PROJECT_ID 和 PROJECT_NUMBER,請參閱「識別專案」。
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com \ --role=roles/healthcare.serviceAgent
如果要求成功,命令提示字元就會顯示類似以下範例的訊息:
Updated IAM policy for project [PROJECT_ID]. bindings: ... - members: - serviceAccount:service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount.com role: roles/healthcare.serviceAgent ... etag: VALUE version: VALUE
再次返回「Identity and Access Management」頁面,確認下列事項:
- 「Member」(成員) 欄包含服務帳戶 ID,格式為
service-PROJECT_NUMBER@gcp-sa-healthcare.iam.gserviceaccount。 - 在「Member」(成員) 欄的同一列中,「Name」(名稱) 欄包含「Cloud Healthcare Service Agent」(Cloud Healthcare 服務代理)。
- 在「成員」欄的同一列中,「角色」欄會包含「Healthcare 服務代理」。
FHIR 交易套裝組合因累積負載過重而中止
執行 FHIR 交易套裝組合時,您可能會收到錯誤訊息,指出要求「因執行交易套裝組合的累積負載過重而中止」。
執行交易組合時,可建立的鎖定爭用數量沒有限制。舉例來說,如果您建構一組套件,其中每個套件都會更新單一通用 Patient 資源,並建立一些不通用的其他資源,然後平行執行這些套件,則所需時間會迅速增加,因為每個套件都必須在整個交易中保留該通用 Patient 的鎖定。因此,這些要求會開始逾時。Cloud Healthcare API 偵測到交易套件逾時,會暫時拒絕所有交易套件,並顯示這則錯誤訊息,嘗試清除爭用。
如要避免這個問題,可以嘗試下列任一做法:
- 如果不需要交易語意,請使用批次套件。批次套件並非不可分割,因此可完全避免這個問題。不過,這會降低參照完整性強制執行的效果。
- 如果您能找出平行更新的資源,請判斷是否可以排除或避免這些更新。在 FHIR 中,如果您建立新的資源 (例如 Observation),同時更新已存在且未變更的相關聯 Patient (或 Organization、Location、Device 等),就會發生這種情況。
- 在用戶端限制頻率;如果交易套件需要很長時間才能執行,請在要求開始逾時前降低擷取頻率。