Snowflake 故障診斷 - Amazon Data Firehose
Firehose 串流建立失敗

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Snowflake 故障診斷

本節說明使用 Snowflake 做為目的地時的常見疑難排解步驟

Firehose 串流建立失敗

如果將資料交付至啟用 PrivateLink 的 Snowflake 叢集的串流建立失敗，則表示 Firehose 無法存取 VPCE-ID。這可能是下列其中一個原因所造成：

  • VPCE-ID 不正確。確認沒有排版錯誤。

  • Firehose 不支援預覽版中的無區域 Snowflake URLs。使用 Snowflake 帳戶定位器提供 URL。如需詳細資訊，請參閱 Snowflake 文件。

  • 確認 Firehose 串流是在與 Snowflake AWS 區域相同的區域中建立。

  • 如果問題仍然存在，請聯絡 AWS 支援。

交付失敗

如果資料未交付到您的 Snowflake 資料表，請檢查下列項目。Snowflake 交付失敗的資料將與錯誤代碼和對應至承載的錯誤訊息一起交付至 S3 錯誤儲存貯體。以下是幾個常見的錯誤案例。如需錯誤代碼的完整清單，請參閱 Snowflake 資料交付錯誤。

  • 錯誤代碼：Snowflake.DefaultRoleMissing：表示建立 Firehose 串流時未設定 snowflake 角色。如果未設定 Snowflake 角色，請確定您將預設角色設定為指定的 Snowflake 使用者。

  • 錯誤代碼：Snowflake.ExtraColumns：表示插入 Snowflake 因輸入承載中的額外資料欄而遭拒。不應指定資料表中不存在的資料欄。請注意，Snowflake 資料欄名稱區分大小寫。如果即使資料欄出現在資料表中，交付仍失敗，請確定輸入承載中的資料欄名稱大小寫符合資料表定義中宣告的資料欄名稱。

  • 錯誤代碼：Snowflake.MissingColumns：表示插入 Snowflake 因輸入承載中缺少資料欄而遭到拒絕。確定為所有不可為空的資料欄指定值。

  • 錯誤碼：Snowflake.InvalidInput：當 Firehose 無法將提供的輸入承載剖析為有效的 JSON 格式時，可能會發生這種情況。請確定 json 承載格式良好，沒有額外的雙引號、引號、逸出字元等。目前，Firehose 僅支援單一 JSON 項目做為記錄承載，不支援 JSON 陣列。

  • 錯誤代碼：Snowflake.InvalidValue：表示由於輸入承載中的資料類型不正確而導致交付失敗。請確定輸入承載中指定的 JSON 值符合 Snowflake 資料表定義中宣告的資料類型。

  • 錯誤碼：Snowflake.InvalidTableType：表示不支援在 Firehose 串流中設定的資料表類型。請參閱受支援資料表、資料欄和資料類型的 snowpipe 串流限制)。

注意

基於任何原因，如果在建立 Firehose 串流後變更 Snowflake 目的地上的資料表定義或角色許可，Firehose 可能需要幾分鐘的時間來偵測這些變更。如果您因此看到交付錯誤，請嘗試刪除並重新建立 Firehose 串流。