報錯信息：ErrorCode=NoSuchPartition, ErrorMessage=The specified partition does not exist.

• 產生原因

  目標分區不存在。

• 解決措施

  執行show partitions <table_name>;命令確認分區名稱正確性，或者為目標表創建新的分區。更多創建分區信息，請參見添加分區。

報錯信息：ErrorCode=Unauthorized, ErrorMessage=The request authorization header is invalid or missing.

• 產生原因

  AccessKey不正確，無法通過身份校驗。

• 解決措施

  您可以進入AccessKey管理頁面獲取正確的AccessKey。如果AccessKey配置無誤，請加入釘釘群進行反饋，并提供使用該AccessKey成功上傳或下載的日志信息。

報錯信息：ErrorCode=Local Error, Failed to create download session with tunnel endpoint.

• 產生原因

  • 原因一：網絡未連通。

  • 原因二：表或分區的小文件太多。

• 解決措施

  • 原因一的解決措施：

    在報錯設備的命令行窗口，使用curl命令連接報錯信息中的Tunnel Endpoint，驗證是否可以正常訪問。

    • 如果可以正常訪問，會返回如下信息。此時請跳過該步驟，根據下方原因二的解決措施進行處理。

    • 如果無法正常訪問，請檢查并修改Tunnel Endpoint配置。

      外網的Tunnel Endpoint以aliyun.com結尾，經典網絡或VPC網絡的Tunnel Endpoint以aliyun-inc.com結尾。請您根據實際業務情況配置正確的Tunnel Endpoint。更多Tunnel Endpoint信息，請參見Endpoint。

      說明

      如果您通過外網設備訪問經典網絡或VPC網絡的Tunnel Endpoint，或者通過經典網絡或VPC網絡設備訪問外網的Tunnel Endpoint，有可能網絡不通。

  • 原因二的解決措施：

    通過MaxCompute客戶端或DataWorks客戶端執行desc extended命令，查看表或分區的文件數量。

    desc extended <table_name> [partition(partition_spec)];

    返回結果中的FileNum即為文件數量。當文件數量超過1000個時，需要合并小文件。

    如果您的項目還使用了Instance Tunnel下載數據，同樣受表文件數量影響。當文件數量過多時，就會存在超時問題。如果不需要下載SQL結果數據，可以關閉Instance Tunnel，SQL的執行過程并不受Limit參數影響，會把全表的數據都列出來。如果期望達到查詢加速的效果，可以添加WHERE條件，例如查找沒有NULL值的列，可以添加where xxx not null語句，生成一份臨時數據，不需要全表掃描。

報錯信息：ErrorCode=NoSuchProject, ErrorMessage=The specified project name does not exist.

• 產生原因

  MaxCompute項目名稱不正確或Tunnel Endopint不正確。

• 解決措施

  • 檢查并修改項目名稱。

    您可以登錄MaxCompute控制臺，左上角切換地域后，即可在項目管理頁簽查看到具體的MaxCompute項目名稱。

  • 檢查并修改Tunnel Endpoint

    各地域各網絡對應的Tunnel Endopint信息，請參見Endpoint。

報錯信息：ErrorCode=NoPermission, ErrorMessage=Authorization Failed [4019], You have NO privilege 'odps:Update' on.

• 產生原因

  沒有上傳數據權限。

• 解決措施

  您可以通過DataWorks的數據地圖，申請目標表的Update權限，或者由項目所有者或表所有者授予表的Update權限。更多授權信息，請參見MaxCompute權限。

報錯信息：ErrorCode=NoPermission, ErrorMessage=Authorization Failed [4019], You have NO privilege 'odps:Download' on.

• 產生原因

  沒有下載數據權限。

• 解決措施

  您可以通過DataWorks的數據地圖，申請目標表的Download權限，或者由項目所有者或具備Super_Administrator角色的用戶授予表的Download權限。更多Download授權信息，請參見Policy權限控制。

報錯信息：ErrorCode=NoPermission, ErrorMessage=Authorization Failed [4021], You have NO privilege 'odps:Select' on 'xxx'，project 'xxx' is protected.

• 產生原因

  MaxCompute項目設置了數據保護機制，禁止使用Tunnel下載數據。

• 解決措施

  聯系項目所有者（Project Owner）設置Exception Policy，為用戶授權。更多Exception Policy信息，請參見數據流出策略一：設置Exception Policy。

報錯信息：ErrorCode=InvalidBlockID, ErrorMessage=The specified block id is not valid.xxxx.

• 產生原因

  多任務并發，BlockID非法。

• 解決措施

  減小并發度，同時您可以執行如下命令清理5天前的日志。

  tunnel purge 5;

報錯信息：ErrorCode=TableModified, ErrorMessage=The specified table has been modified since the download initiated. Try initiate another download.

• 產生原因

  下載數據過程中，表被修改了。

• 解決措施

  需要重新創建Download Session下載數據。您可以通過如下方式查看修改記錄：

  • 查看DDL操作記錄：通過DataWorks的數據地圖功能，查看表的變更記錄，請參見查看明細信息。

  • 查看表數據修改記錄：通過元數據視圖或審計日志查看數據變更記錄。

報錯信息：ErrorCode=StatusConflict, ErrorMessage=The download session is expired.

• 產生原因

  下載超過24小時，導致Session過期。

• 解決措施

  重新創建Download Session下載數據。需要注意的是：

  • Download Session如果沒有主動關閉，超過24小時會自動失效。

  • 創建Download Session后，如果表被修改了，Download Session也會失效。

報錯信息：ErrorCode=StatusConflict, ErrorMessage=You cannot complete the specified operation under the current upload or download status.

• 產生原因

  • 原因一：Upload Session已經提交。

  • 原因二：表或分區內的小文件太多。

• 解決措施

  • 原因一的解決措施：重新創建Upload Session上傳數據。

  • 原因二的解決措施：合并小文件，請參見合并小文件。

報錯信息：ErrorCode=InvalidProjectTable, ErrorMessage=The specified project or table name is not valid or missing.

• 產生原因

  項目名稱或表名稱不正確。

• 解決措施

  檢查項目名稱或表名稱的正確性并修改。

  您可以登錄MaxCompute控制臺，左上角切換地域后，即可在項目管理頁簽查看到具體的MaxCompute項目名稱。

  您可以執行show tables;命令查看表的名稱。

報錯信息：ErrorCode=InvalidPartitionSpec, ErrorMessage=Error: The specified partitionspec is not valid.

• 產生原因

  分區字段不正確或格式有誤。

• 解決措施

  您可以執行show partitions <table_name>;命令查看表的分區。檢查分區字段信息，確保滿足如下要求：

  • 參數中的分區列順序要與建表語句中分區列順序保持一致。

  • 當分區列值中有引號(pt='a'或pt="a")時，舊版本SDK沒有做過引號處理，需要使用新版本的Tunnel SDK。

  • 多級分區中間有空格時，例如pt1=a, pt2=a，需要把空格刪掉。

  • 多級分區需要填寫所有的分區。

  • 分區名大小寫要與建表語句保持一致。

報錯信息：ErrorCode=InvalidRowRange, ErrorMessage=The specified row range is not valid.

• 產生原因

  openReader的兩個參數startOffset和count取值有問題。

• 解決措施

  檢查代碼確保滿足如下要求：

  • startOffset必須大于等于0。

  • count必須大于0。

報錯信息：ErrorCode=StatusConflict, ErrorMessage=Cannot close upload now: Close Upload Session Failed.Because of Status Conflict.Current Status:critical.

• 產生原因

  DDL操作失敗，導致Upload Session狀態異常。

• 解決措施

  重新創建Upload Session。

報錯信息：ErrorCode=StatusConflict, ErrorMessage=The upload|download session is expired.

• 產生原因

  Upload Session或Download Session超過24小時，已失效。

• 解決措施

  重新創建Upload Session或Download Session。

報錯信息：ErrorCode=FlowExceeded, ErrorMessage=Your flow quota is exceeded.

請填寫釘釘群申請表單加入釘釘群進行反饋。

報錯信息：ErrorMessage=java.net.SocketException: Connection reset.

• 產生原因

  常見于使用SDK編寫的程序或者第三方平臺通過Tunnel讀取數據進行處理的過程。服務端有連接保護，打開RecordReader后長時間不讀數據，服務端會斷開連接，時限為300秒。圖示如下。

  

  RecordReader內部有緩存，一旦用戶的計算或處理邏輯較為緩慢，未能在超時時限內處理完一塊緩存數據并觸發下一次讀取，則會出現該錯誤。

• 解決措施

  優化代碼處理邏輯。

報錯信息：ErrorCode=Unauthorized ErrorMessage=The request authorization header is invalid or missing. Message:The signatrue is Time-Expired.

• 產生原因

  簽名的時間校驗未通過。

• 解決措施

  檢查客戶端系統時間，時間差不能超過15分鐘。Tunnel服務端會定時NTP授時，一般是準確的。如果確定客戶端系統時間沒問題，請填寫釘釘群申請表單加入釘釘群進行反饋。

  如果使用Tunnel SDK開發時遇到這個錯誤，需要保證Open Writer與寫入數據之間的時間間隔不能超過15分鐘，簽名在Open Writer時生成。

報錯信息：ErrorCode=MalformedDataStream ErrorMessage=The data stream you provided was not well-formed or did not validate against schema.

• 產生原因

  上傳數據的結構和目標表的結構不一致。

• 解決措施

  檢查上傳數據的結構與目標表的結構，確保二者一致。

報錯信息：ErrorCode=MethodNotAllowed, ErrorMessage=The specified method is not allowed against clustered table and partition.

• 產生原因

  Tunnel暫時不支持Clustered Table上傳。

• 解決措施

  無。

報錯信息：ErrorCode=InstanceNotTerminate, ErrorMessage=The instance does not terminate.

• 產生原因

  下載的Instance還未運行完。

• 解決措施

  等待Instance運行完成后再下載。