管理分區資料表

主控台

您無法在 Google Cloud 控制台中更新分區到期時間。

SQL

使用 ALTER TABLE SET OPTIONS 陳述式。以下範例會將到期日更新為 5 天。如要移除資料表的分區到期日，請將 partition_expiration_days 設為 NULL。

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

   前往 BigQuery

2. 在查詢編輯器中輸入以下陳述式：

   ALTER TABLE mydataset.mytable
     SET OPTIONS (
       -- Sets partition expiration to 5 days
       partition_expiration_days = 5);

3. 按一下 play_circle「Run」。

如要進一步瞭解如何執行查詢，請參閱「執行互動式查詢」一文。

bq

發出含有 --time_partitioning_expiration 旗標的 bq update 指令。如果您要更新非預設專案中的分區資料表，請使用下列格式將專案 ID 新增至資料集名稱：project_id:dataset。

bq update \
--time_partitioning_expiration integer_in_seconds \
--time_partitioning_type unit_time \
project_id:dataset.table

其中：

• integer 是資料表分區的預設生命週期 (以秒為單位)，這個值沒有下限。到期時間為分區日期加整數值。如果您指定 0，就會移除分區到期時間，分區將永遠不會過期。沒有到期時間的分區必須手動刪除。
• unit_time 會根據資料表的分區精細程度，採用 DAY、HOUR、MONTH 或 YEAR。這個值必須與您在建立資料表時設定的精細程度相符。
• project_id 是您的專案 ID。
• dataset 是含有您要更新資料表的資料集名稱。
• table 是您要更新之資料表的名稱。

範例：

輸入下列指令，將 mydataset.mytable 中的分區到期時間更新為 5 天 (432000 秒)。mydataset 在您的預設專案中。

bq update --time_partitioning_expiration 432000 mydataset.mytable

輸入下列指令，將 mydataset.mytable 中的分區到期時間更新為 5 天 (432000 秒)。mydataset 在 myotherproject 中，而不是您的預設專案中。

bq update \
--time_partitioning_expiration 432000 \
myotherproject:mydataset.mytable

API

呼叫 tables.patch 方法，並使用 timePartitioning.expirationMs 屬性來更新分區到期時間 (以毫秒為單位)。由於 tables.update 方法會取代整個資料表資源，因此建議使用 tables.patch 方法。

主控台

建立分區資料表後，您就無法使用 Google Cloud 主控台來要求使用分區篩選器。

SQL

使用 ALTER TABLE SET OPTIONS 陳述式更新分區篩選器必要條件。以下範例會將要求更新為 true：

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

   前往 BigQuery

2. 在查詢編輯器中輸入以下陳述式：

   ALTER TABLE mydataset.mypartitionedtable
     SET OPTIONS (
       require_partition_filter = true);

3. 按一下 play_circle「Run」。

如要進一步瞭解如何執行查詢，請參閱「執行互動式查詢」一文。

bq

如要使用 bq 指令列工具更新分區資料表，以要求使用分區篩選器，請輸入 bq update 指令並加上 --require_partition_filter 標記。

如要更新非預設專案中的分區資料表，請使用下列格式將專案 ID 新增到資料集：project_id:dataset。

例如：

如要在預設專案中更新 mydataset 中的 mypartitionedtable，請輸入：

bq update --require_partition_filter mydataset.mytable

如要在 myotherproject 中更新 mydataset 中的 mypartitionedtable，請輸入：

bq update --require_partition_filter myotherproject:mydataset.mytable

API

呼叫 tables.patch 方法並將 requirePartitionFilter 屬性設定為 true 以要求使用分區篩選器。由於 tables.update 方法會取代整個資料表資源，因此建議使用 tables.patch 方法。

Java

import com.google.cloud.bigquery.BigQuery;
import com.google.cloud.bigquery.BigQueryException;
import com.google.cloud.bigquery.BigQueryOptions;
import com.google.cloud.bigquery.Table;

// Sample to update require partition filter on a table.
public class UpdateTableRequirePartitionFilter {

  public static void runUpdateTableRequirePartitionFilter() {
    // TODO(developer): Replace these variables before running the sample.
    String datasetName = "MY_DATASET_NAME";
    String tableName = "MY_TABLE_NAME";
    updateTableRequirePartitionFilter(datasetName, tableName);
  }

  public static void updateTableRequirePartitionFilter(String datasetName, String tableName) {
    try {
      // Initialize client that will be used to send requests. This client only needs to be created
      // once, and can be reused for multiple requests.
      BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();

      Table table = bigquery.getTable(datasetName, tableName);
      table.toBuilder().setRequirePartitionFilter(true).build().update();

      System.out.println("Table require partition filter updated successfully");
    } catch (BigQueryException e) {
      System.out.println("Table require partition filter was not updated \n" + e.toString());
    }
  }
}

主控台

Google Cloud 主控台不支援複製分區。

bq

如要複製分區，請使用 bq 指令列工具的 bq cp (複製) 指令與分區修飾符 ($date)，例如 $20160201。

選用標記可用來控管目的地分區的寫入配置：

• -a 或 --append_table：把來源分區的資料附加到目的地資料集中的現有資料表或分區。
• -f 或 --force：覆寫目的地資料集中的現有資料表或分區，此作業不會有確認提示。
• 如果目的地資料集裡已有資料表或分區，-n 或 --no_clobber 會傳回下列錯誤訊息：Table '<var>project_id:dataset.table</var> or <var>table$date</var>' already exists, skipping.。如未指定 -n，預設行為是提示您選擇是否要取代目的地資料表或分區。
• --destination_kms_key：客戶管理的 Cloud KMS 金鑰，可用來加密目的地資料表或分區。

cp 指令不支援 --time_partitioning_field 或 --time_partitioning_type 旗標。您無法使用複製工作將擷取時間分區資料表轉換為分區資料表。

本文不示範 --destination_kms_key。詳情請參閱「使用 Cloud KMS 金鑰保護資料」一文。

如果來源或目的地資料集位於非預設專案中，請採用下列格式將專案 ID 新增至該資料集名稱：project_id:dataset。

(選用) 提供 --location 旗標，並將值設為您的位置。

bq --location=location cp \
-a -f -n \
project_id:dataset.source_table$source_partition \
project_id:dataset.destination_table$destination_partition

其中：

• location 是您的位置名稱。--location 是選用旗標。舉例來說，如果您在東京地區使用 BigQuery，就可以將旗標的值設為 asia-northeast1。您可以使用 .bigqueryrc 檔案，設定該位置的預設值。
• project_id 是您的專案 ID。
• dataset 是來源或目的地資料集的名稱。
• source_table 是您要複製的資料表。
• source_partition 是來源分區的分區修飾符。
• destination_table 是目的地資料集中的資料表名稱。
• destination_partition 是目的地分區的分區裝飾符。

範例：

將分區複製到新資料表

輸入下列指令，將 2018 年 1 月 30 日的分區從 mydataset.mytable 複製到新資料表：mydataset.mytable2。mydataset 在您的預設專案中。

bq cp -a 'mydataset.mytable$20180130' mydataset.mytable2

將分區複製到非分區資料表

輸入下列指令，將 2018 年 1 月 30 日的分區從 mydataset.mytable 複製到非分區資料表：mydataset2.mytable2。-a 捷徑可用來將分區的資料附加至非分區目的地資料表。兩個資料集都在您的預設專案中。

bq cp -a 'mydataset.mytable$20180130' mydataset2.mytable2

輸入下列指令，將 2018 年 1 月 30 日的分區從 mydataset.mytable 複製到非分區資料表：mydataset2.mytable2。-f 捷徑可用來在無提示的情況下覆寫非分區目的地資料表。

bq --location=US cp -f 'mydataset.mytable$20180130' mydataset2.mytable2

將分區複製到其他分區資料表

輸入下列指令，將 2018 年 1 月 30 日的分區從 mydataset.mytable 複製到其他分區資料表：mydataset2.mytable2。-a 捷徑可用來將分區的資料附加至目的地資料表。由於目的地資料表上未指定分區修飾符，因此會保留來源分區索引鍵，並將資料複製到目的地資料表中 2018 年 1 月 30 日的分區。您也可以在目的地資料表上指定分區修飾符，將資料複製到指定的分區。mydataset 在您的預設專案中。mydataset2 在 myotherproject 中，而不是您的預設專案中。

bq --location=US cp \
-a \
'mydataset.mytable$20180130' \
myotherproject:mydataset2.mytable2

輸入下列指令，將 2018 年 1 月 30 日的分區從 mydataset.mytable 複製到另一個分區資料表 mydataset2.mytable2 的 2018 年 1 月 30 日分區。-f 捷徑可用來在無提示的情況下覆寫目的地資料表中 2018 年 1 月 30 日的分區。如未使用分區修飾符，則會覆寫目的地資料表中的所有資料。mydataset 在您的預設專案中。mydataset2 在 myotherproject 中，而不是您的預設專案中。

bq cp \
-f \
'mydataset.mytable$20180130' \
'myotherproject:mydataset2.mytable2$20180130'

輸入下列指令，將 2018 年 1 月 30 日的分區從 mydataset.mytable 複製到其他分區資料表：mydataset2.mytable2。mydataset 在您的預設專案中。mydataset2 在 myotherproject 中，而不是您的預設專案中。如果目的地資料表中有資料，則預設行為是提示您進行覆寫。

bq cp \
'mydataset.mytable$20180130' \
myotherproject:mydataset2.mytable2

如要複製多個分區，請以逗號分隔清單的形式指定分區：

bq cp \
'mydataset.mytable$20180130,mydataset.mytable$20180131' \
myotherproject:mydataset.mytable2

API

呼叫 jobs.insert 方法，並設定 copy 工作。(選用) 在工作資源的 jobReference 區段中，於 location 屬性指定您的位置。

在工作設定中指定下列屬性：

• 在 sourceTables 屬性中輸入來源資料集、資料表和分區。
• 在 destinationTable 屬性中輸入目的地資料集和資料表。
• 使用 writeDisposition 屬性指定要附加或覆寫目的地資料表或分區。

如要複製多個分區，請在 sourceTables 屬性中輸入來源分區 (包括資料集和資料表名稱)。

主控台

Google Cloud 主控台不支援刪除分區。

SQL

如果符合條件的 DELETE 陳述式涵蓋分區中的所有資料列，BigQuery 就會移除整個分區。這項移除作業不會掃描位元組或耗用插槽。以下 DELETE 陳述式的範例涵蓋 _PARTITIONDATE 虛擬欄上篩選器的整個分區：

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

   前往 BigQuery

2. 在查詢編輯器中輸入以下陳述式：

   DELETE mydataset.mytable
   WHERE _PARTITIONDATE IN ('2076-10-07', '2076-03-06');

3. 按一下 play_circle「Run」。

如要進一步瞭解如何執行查詢，請參閱「執行互動式查詢」一文。

bq

使用 bq rm 指令並搭配 --table 旗標 (或 -t 捷徑)，並指定分區修飾符來刪除特定分區。

bq rm --table project_id:dataset.table$partition

其中：

• project_id 是您的專案 ID。如果未指定，系統會使用預設專案。
• dataset 是包含該資料表之資料集的名稱。
• table 是資料表名稱。
• partition 是您要刪除的分區的分區修飾符。

分區裝飾子具有下列格式，具體取決於分區類型：

• 按小時劃分的時間區段：yyyymmddhh。範例：$2016030100。
• 每日區隔：yyyymmdd。範例：$20160301。
• 月度區隔：yyyymm。範例：$201603。
• 年度區隔：yyyy。範例：$2016。
• 整數範圍分區：分區範圍的起始值。範例：$20。

bq 指令列工具會提示您確認動作。如要略過確認程序，請使用 --force 標記 (或 -f 捷徑)。

範例：

在預設專案中，刪除名為 mydataset.mytable 的每日分區資料表中的 2016 年 3 月 1 日分區：

bq rm --table 'mydataset.mytable$20160301'

刪除每月分區資料表中的 2016 年 3 月分區：

bq rm --table 'mydataset.mytable$201603'

在名為 mydataset.mytable 的整數範圍分區資料表中，刪除起始值為 20 的整數範圍：

bq rm --table 'mydataset.mytable$20'

API

呼叫 tables.delete 方法，並使用 tableId 參數來指定資料表和分區修飾符。