Skip to main content
Version: v4

BigQuery

BigQuery 限制
  • 不支援 View
  • 不支援 BIGNUMERIC (alias to BIGDECIMAL), GEOGRAPHY 等 Type

Step 1: 準備服務帳號 (Service Account)​

Canner Enterprise 使用 服務帳號 (Service Account) 的 Authentication 方式操作 Google Cloud APIs，故需準備 服務帳號 (Service Account)

請參考 Google Cloud Authenticating as a service account > Creating a service account 部分

  1. 到 Google Cloud Create Service Account 頁面
  2. 選擇專案
  3. 開始建立服務帳號 (Service Account)，輸入像以下的資訊 connect_bq_sa_step1
  4. 點選繼續，在第二個步驟中，授與 BigQuery 資料檢視者 及 BigQuery 使用者 兩個角色 connect_bq_sa_step2
  5. 跳過第三步驟，點選完成，接著會回到列表畫面，點選剛剛創建的服務帳號 connect_bq_sa_success
  6. 點選 金鑰，點擊 新增金鑰，選擇 JSON 類型 connect_bq_sa_key
  7. 下載後的 JSON 內容會如下 connect_bq_sa_json

Step 2: 建立資料來源​

您可以透過以下兩種操作來建立資料來源，第一種為點擊側欄 Data Source 的 “+” 按鈕，或是點擊 Overview 頁面中的 Create a Data Source 按鈕來建立。

1_bigquery

Step 3: 設定連線資訊​

在彈出的視窗表單中，填入及設定連線資訊，並點擊 Submit 送出。

3_bigquery

相關連線欄位設定細節如下方說明。

Basic​

  • Name：資料庫於 Canner Enterprise 之顯示名稱，後續可作修改。
  • Data Source Type : 資料庫類型，請選擇 BigQuery。

Data Source Properties​

  • Project ID: 請填入您要連結的 BigQuery 所屬 Goole Cloud Platform 上的 Project ID。
  • Parent Project ID: 請填入前項 Project ID 的所屬 Parent Project ID。
  • Dataset ID: 請填入欲連結的 Dataset ID。
如何在 GCP BigQuery 上找到 Project ID, Parent Project ID, Dataset ID 等資訊

  1. 在 BigQuery 畫面上，在欲連接的 Dataset 上，在更多選項中點擊 開啟 get_bq_info

  2. 可在資訊中，看到 project_id:dataset_id 這樣的字串，這邊就可取得 Project ID 及 Dataset ID，而 Parent Project ID 若當初建置 Project 時沒有特別設定階層，通常跟 Project ID 是一樣的 get_bq_info_2

  • Encoded Credentials: Service Account 的金鑰內容
如何填入 Service Account 的金鑰內容
  1. 點擊該 input 右邊的鉛筆 Icon 4_bigquery
  2. 在跳出的視窗中貼上，Step1 中 JSON 的內容後，點擊 Convert，就可回到表單繼續完成其他欄位的填寫 5_bigquery
  • Case Insensitive： Canner Enterprise 資料來源中所連結之資料表(Table)名稱皆會統一格式為小寫顯示，不支援以大小寫區分。若您 BigQuery 中的資料表(Table)名稱及欄位(Column)名稱皆為小寫，建議可開啟此選項，可加速系統連結時間。
  • Explore Timeout：系統連結資料來源的逾時限制，若系統執行連結超過此時間，會自動終止並顯示連線錯誤。系統預設逾時限制為 10000 毫秒 ，若您要連結的資料庫中資料表(Table) 數量較多，建議可調高此逾時限制。

Step 4: 完成建立​

進行 Submit 後，稍後片刻將會在側欄中顯示 BigQuery 的資料來源，點擊後可以進入此資料來源細節頁面。

6_bigquery