CREATE EXTERNAL TABLE

要建立的資料表名稱，以外部結構描述名稱限定。外部資料表必須建立在外部結構描述中。如需詳細資訊，請參閱CREATE EXTERNAL SCHEMA。

資料表名稱的長度上限為 127 個位元組；超過此長度的名稱會截斷至 127 個位元組。您最多可以使用 UTF -8 個多位元組字元，最多四個位元組。Amazon Redshift 會強制執行每個叢集 9,900 個資料表的限制，包括使用者定義的臨時資料表，以及 Amazon Redshift 在查詢處理或系統維護期間建立的臨時資料表。您也可以選擇使用資料庫名稱來限定資料表名稱。在以下範例中，資料庫名稱為 spectrum_db，外部結構描述名稱為 spectrum_schema，而資料表名稱為 test。

create external table spectrum_db.spectrum_schema.test (c1 int)
stored as parquet
location 's3://amzn-s3-demo-bucket/myfolder/';

如果指定的資料庫或結構描述不存在，則不會建立資料表，而且陳述式會傳回錯誤。您無法在系統資料庫 template0、template1、padb_harvest 和 sys:internal 中建立資料表或檢視。

資料表名稱對於指定的結構描述來說必須是唯一的。

如需有效名稱的相關資訊，請參閱 名稱與識別碼。

要建立的每個資料欄的名稱和資料類型。

資料欄名稱的長度上限為 127 個位元組；超過此長度的名稱會截斷至 127 個位元組。您最多可以使用 UTF -8 個多位元組字元，最多四個位元組。您無法指定資料欄名稱 "$path" 或 "$size"。如需有效名稱的相關資訊，請參閱 名稱與識別碼。

Amazon Redshift 預設會以虛擬資料欄 $path 和 $size 建立外部資料表。您可以藉由將 spectrum_enable_pseudo_columns 組態參數設定為 false，以停用工作階段的虛擬資料欄建立。如需詳細資訊，請參閱虛擬資料欄 。

若已啟用虛擬資料欄，則單一資料表中可定義的資料欄數目上限為 1,598 個。若未啟用虛擬資料欄，則單一資料表中可定義的資料欄數目上限為 1,600 個。

若您要建立「寬資料表」，則務必確定在載入和查詢處理期間，您的資料欄清單未超過中繼結果的資料列寬度界限。如需詳細資訊，請參閱使用須知。

對於 CREATE EXTERNAL TABLE AS 命令，不需要列列列表，因為列是從查詢派生的。

支援以下 資料類型：

對於DATE，您可以使用如下所述的格式。使用數字表示的月份值支援下列格式：

使用三個字母縮寫表示的月份值支援下列格式：

對於始終小於 100 的年份值，年份的計算方式如下：

文字檔案中的時間戳記值格式必須為 yyyy-mm-dd HH:mm:ss.SSSSSS，如以下的時間戳記值所示：2017-05-01 11:30:59.000000。

VARCHAR列的長度是以字節定義的，而不是字符。例如，一個 VARCHAR (12) 資料行可以包含 12 個單一位元組字元或 6 個雙位元組字元。查詢外部資料表時，結果會截斷以配合定義的資料欄大小，而不會傳回錯誤。如需詳細資訊，請參閱儲存與範圍。

為獲得最佳效能，建議您指定可配合您的資料的最小資料欄大小。若要尋找資料行中值的最大大小 (以位元組為單位)，請使用 OCTET_ LENGTH 函數。下列範例會傳回電子郵件資料欄中值的大小上限。

select max(octet_length(email)) from users;

max
---
 62

此子句會定義包含一個或多個分割區資料欄的分割資料表。每種指定的組合都會另外使用一個資料目錄，這樣可在某些情況下改善查詢效能。資料表資料內並未包含分割資料欄。如果您對 col_name 使用的值與資料表資料欄相同，則會發生錯誤。

建立分區資料表之後，請使用ALTER TABLE... ADD PARTITION 陳述式來變更資料表，將新的分割區註冊至外部目錄。當您新增分割區時，會定義 Amazon S3 上包含分割區資料的子資料夾位置。

例如，如果資料表spectrum.lineitem_part是使用定義的PARTITIONED BY (l_shipdate date)，請執行下列ALTERTABLE命令來新增分割區。

ALTER TABLE spectrum.lineitem_part ADD PARTITION (l_shipdate='1992-01-29')
LOCATION 's3://spectrum-public/lineitem_partition/l_shipdate=1992-01-29';

如果您使用的是 CREATE EXTERNAL TABLE AS，則不需要運行 ALTERTABLE... ADDPARTITION。Amazon Redshift 會自動在外部目錄中註冊新的分割區。Amazon Redshift 也會根據資料表中定義的一個或多個分割區索引鍵，自動將對應的資料寫入 Amazon S3 中的分割區。

若要檢視分割區，請查詢 SVV_EXTERNAL_PARTITIONS 系統畫面。

此子句會指定基礎資料的格式。rowformat 可能的值如下：

指定「分隔符號」的單一ASCII字元。您可以使用八進制指定非打印ASCII字符，格式'\ddd'd為八進制數字（0—7），最多為 '\ 177'。下面的例子指定使用八進制BEL（bell）字符。

ROW FORMAT DELIMITED FIELDS TERMINATED BY '\007'

如果省ROWFORMAT略，則默認格式為 DELIMITED FIELDS TERMINATED BY '\ A'（標題的開始）和 LINES TERMINATED BY'\ n '（換行符）。

指定基礎資料SERDE格式的子句。

如果省ROWFORMAT略，則默認格式為 DELIMITED FIELDS TERMINATED BY '\ A'（標題的開始）和 LINES TERMINATED BY'\ n '（換行符）。

資料檔案的檔案格式。

有效格式如下：

CREATEEXTERNALTABLEAS 指令僅支援兩種檔案格式TEXTFILE和PARQUET。

對於INPUTFORMAT和OUTPUTFORMAT，指定類別名稱，如下列範例所示。

'org.apache.hadoop.mapred.TextInputFormat'

包含資料檔案的 Amazon S3 儲存貯體或資料夾路徑，或包含 Amazon S3 物件路徑清單的資訊清單檔案。儲存貯體必須與 Amazon 紅移叢集位於相同的 AWS 區域。如需支援的 AWS 區域清單，請參閱Amazon Redshift Spectrum 考量事項。

如果路徑指定的是儲存貯體或資料夾，例如 's3://amzn-s3-demo-bucket/custdata/'，則 Redshift Spectrum 會掃描指定儲存貯體或資料夾以及任何子資料夾裡的檔案。Redshift Spectrum 會忽略隱藏檔案以及開頭為句號或底線的檔案。

如果路徑指定的是資訊清單檔案，則 's3://bucket/manifest_file' 引數必須明確參考單一檔案，例如 's3://amzn-s3-demo-bucket/manifest.txt'。無法參考金鑰前綴。

資訊清單是JSON格式的文字檔，列出URL要從 Amazon S3 載入的每個檔案，以及檔案大小 (以位元組為單位)。包URL括檔案的值區名稱和完整物件路徑。資訊清單中指定的檔案可以位於不同的值區中，但所有值區都必須與 Amazon Redshift 叢集位於相同的 AWS 區域中。如果某個檔案列出兩次，則該檔案會載入兩次。下列範例顯示JSON載入三個檔案的資訊清單。

{
  "entries": [
    {"url":"s3://amzn-s3-demo-bucket1/custdata.1", "meta": { "content_length": 5956875 } },
    {"url":"s3://amzn-s3-demo-bucket1/custdata.2", "meta": { "content_length": 5997091 } },
    {"url":"s3://amzn-s3-demo-bucket2/custdata.1", "meta": { "content_length": 5978675 } }
  ]
}

您可以讓包含特定檔案變為強制性。若要這麼做，請在資訊清單中的檔案層級包含 mandatory 選項。當您查詢具有遺失必要檔案的外部資料表時，SELECT陳述式會失敗。確定外部資料表定義中包含的所有檔案均存在。如果並非全部存在，則會出現錯誤，顯示找不到第一個強制性檔案。下列範例顯示mandatory選項設定JSON為的資訊清單true。

{
  "entries": [
    {"url":"s3://amzn-s3-demo-bucket1/custdata.1", "mandatory":true, "meta": { "content_length": 5956875 } },
    {"url":"s3://amzn-s3-demo-bucket1/custdata.2", "mandatory":false, "meta": { "content_length": 5997091 } },
    {"url":"s3://amzn-s3-demo-bucket2/custdata.1", "meta": { "content_length": 5978675 } }
  ]
}

若要參考使用建立的檔案UNLOAD，您可以使用使用MANIFEST參數建立UNLOAD的資訊清單。資訊清單檔案與 COPY從 Amazon S3 的資訊清單檔案相容，但使用不同的索引鍵。未使用的索引鍵會加以忽略。

此子句會設定資料表屬性的資料表定義。