在 Dataform 中建立及執行 SQL 工作流程

建立 Dataform 存放區

1. 在 Google Cloud 控制台中，前往「Dataform」頁面。

   前往 Dataform

2. 按一下 add「Create repository」(建立存放區)。

3. 在「建立存放區」頁面中執行下列操作：

   1. 在「Repository ID」(存放區 ID) 欄位中輸入 quickstart-repository。

   2. 在「Region」(區域) 清單中選取「europe-west4」。

   3. 按一下 [建立]。

建立並初始化 Dataform 開發工作區

1. 在 Google Cloud 控制台中，前往「Dataform」頁面。

   前往 Dataform

2. 按一下「quickstart-repository」。

3. 按一下 add「Create development workspace」。

4. 在「建立開發工作區」視窗中執行下列操作：

   1. 在「Workspace ID」(工作區 ID) 欄位中輸入 quickstart-workspace。

   2. 按一下 [建立]。

   開發工作區頁面隨即顯示。

5. 按一下「Initialize workspace」(初始化工作區)。

建立檢視表

在後續章節中，您會定義 view，做為資料表的資料來源。

建立用來定義 view 的 SQLX 檔案

1. 在「檔案」窗格中，點選 definitions/ 旁的 more_vert「更多」選單。

2. 點選「建立檔案」。

3. 在「建立新檔案」窗格中，執行下列步驟：

   1. 在「Add a file path」(新增檔案路徑) 欄位中，輸入 definitions/quickstart-source.sqlx。

   2. 點選「建立檔案」。

定義 view

1. 在「檔案」窗格中，展開「definitions」資料夾。

2. 按一下「definitions/quickstart-source.sqlx」。

3. 在檔案中輸入下列程式碼片段：

   config {
    type: "view"
   }
   
   SELECT
    "apples" AS fruit,
    2 AS count
   UNION ALL
   SELECT
    "oranges" AS fruit,
    5 AS count
   UNION ALL
   SELECT
    "pears" AS fruit,
    1 AS count
   UNION ALL
   SELECT
    "bananas" AS fruit,
    0 AS count
   

4. 按一下「格式」。

建立表格

在接下來的各節中，您將在 SQLX 檔案中定義資料表類型，然後編寫 SELECT 陳述式，以便定義同一檔案的資料表結構。

建立 SQLX 檔案來定義資料表

1. 在「檔案」窗格中，點選 definitions/ 旁的 more_vert「更多」選單，然後選取「建立檔案」。

2. 在「新增檔案路徑」欄位中輸入 definitions/quickstart-table.sqlx。

3. 點選「建立檔案」。

定義資料表類型、結構與依附元件

1. 在「檔案」窗格中展開 definitions/ 目錄。

2. 選取 quickstart-table.sqlx，然後輸入下列資料表類型和 SELECT 陳述式：

   config {
    type: "table"
   }
   
   SELECT
    fruit,
    SUM(count) as count
   FROM ${ref("quickstart-source")}
   GROUP BY 1
   

3. 按一下「格式」。

定義資料表類型後，Dataform 會擲回查詢驗證錯誤，因為 BigQuery 中尚不存在 quickstart-source。稍後在本教學課程中執行 SQL 工作流程時，這項錯誤就會解決。

為 Dataform 授予 BigQuery 存取權

如要使用 Google 帳戶使用者憑證 (預先發布版) 在 BigQuery 中手動執行工作流程，您的 Google 帳戶必須具備下列必要角色：

• 在 Dataform 需要讀取和寫入權限的專案中，授予 BigQuery 資料編輯者角色。通常會包含託管 Dataform 存放區的專案。
• 在 Dataform 需要唯讀存取權的專案中，請使用 BigQuery 資料檢視者。
• 代管 Dataform 存放區的專案中的 BigQuery 工作使用者。

如要授予這些角色，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的「IAM」頁面。

   前往身分與存取權管理頁面

2. 按一下「新增」。

3. 在「新增主體」欄位中輸入 Google 帳戶電子郵件地址 (預覽)。

4. 在「請選擇角色」選單中，選取「BigQuery 工作使用者」角色。

5. 點選「新增其他角色」，然後在「請選擇角色」選單中，選取「BigQuery 資料編輯者」角色。

6. 點選「新增其他角色」，然後在「請選擇角色」選單中，選取「BigQuery 資料檢視者」角色。

7. 按一下 [儲存]。

執行工作流程

1. 在 Google Cloud 控制台中，前往「Dataform」頁面。

   前往 Dataform

2. 在 quickstart-workspace 頁面上，按一下「Start execution」(開始執行)。

3. 按一下「All actions」(所有動作)。

4. 按一下「Start execution」(開始執行)。

5. 在隨即開啟的對話方塊中，按一下「允許」，授予 BigQuery 管道存取 Google 帳戶的權限。

   Dataform 會使用預設存放區設定，在名為 dataform 的 BigQuery 資料集中建立工作流程的內容。

在 Dataform 中查看執行記錄檔

1. 在 quickstart-repository 頁面上，按一下「Workflow Execution Logs」(工作流程執行記錄)。

2. 如要查看執行作業的詳細資料，請點選最新的執行作業。