SQL2750 - SQL2999

解說

配置檔中一行的最大長度必須少於 255 個位元組。

解說

如果因固定長度 ASC 資料檔而需要換行檢查（NEWLINE 參數為 YES 及 RECLEN 參數為非零的值）， 則每一個記錄的真正長度必須符合期望的記錄長度。

解說

字碼頁設定無效。它需為正整數。

解說

程式無法取得其環境的專屬區碼及字碼頁。

解說

資料庫不支援那兩個字碼頁之間的字碼頁轉換。

解說

十進位資料的有效格式是 SQL_PACKEDDECIMAL_FORMAT、 SQL_CHARSTRING_FORMAT 或 SQL_IMPLIEDDECIMAL_FORMAT，彼此互斥。

解說

叢集快取機能 (CF) 結構是 DB2 pureScale 環境中資料庫的記憶體資源。CF 結構包括群組緩衝池 (GBP)、共用通訊區域 (SCA) 和鎖定 (LOCK)。CF 結構的相對應配置參數分別為 CF_GBP_SZ、CF_SCA_SZ 和 CF_LOCK_SZ。

資料庫配置參數 CF_DB_MEM_SZ 會控制此資料庫的總 CF 記憶體限制。所有 CF 結構記憶體都會在此限制內。

如果資料庫配置參數 parameter-name 的值超出 CF_DB_MEM_SZ 的參數值，則無法完成要求而且作業會逾時。

當 CF 結構記憶體更新尚未完成，而且已對相同 CF 結構發出更新記憶體的其他要求時，便會傳回此訊息。

解說

請指定表格名稱或資料庫分割區群組名稱，但不要同時指定兩者。

解說

公用程式需要知道資料庫管理程式的安裝之處，然後它可以發現它的連結檔。

解說

在 sysibm.systables 中找不到表格 tbl-name。

解說

無法在 SYSCAT.DBPARTITIONGROUPDEF 中找到資料庫分割區群組 db-partition-group。

解說

公用程式無法開啟輸出分割對映檔，供寫入資料。它將把輸出寫入至標準輸出中。

解說

分割對映的大小不正確。資料庫中的資料已損毀。

解說

發現無效的指令行選項。

解說

配送對映已從 4096 個項目擴充為 32768 個項目，但是無法由淘汰的 API 傳回。

解說

以 LOAD_ONLY 分割模式執行 load 公用程式時，發現資料檔記錄不符合載入記錄的目標資料庫分割區。

解說

公用程式無法新增、捨棄或變更資料庫分割區，因為原因碼指出的所指定輸入參數無效：

1

未指定資料庫分割區號碼

2

未指定 TCP/IP 主機名稱

3

未指定電腦名稱

4

資料庫分割區號碼無效。

5

埠號無效。

6

TCP/IP 主機名稱無效。

7

Services 檔中未定義您實例的埠值。

8

埠值不在 Services 檔中為您實例定義的有效範圍中。

9

資料庫分割區號碼不是唯一的。

10

這組主機名稱/埠不是唯一的。

11

主機名稱值沒有相對應的埠 0。

解說

DB2NCRT /n:node
        /u:username,password
        [/i:instance]
        [/h:host]
        [/m:machine]
        [/p:port]
        [/o:instance owning
          machine]
        [/g:netname]

解說

DB2NCHG /n:node
        [/h:host]
        [/m:machine]
        [/p:port]
        [/i:instance]
        [/u:username,
          password]
        [/g:netname]

解說

DB2NDROP /n:node
         [/i:instance]

解說

DB2NLIST [/i:instance]
         [/s]

解說

嘗試建立、捨棄或新增資料庫分割區期間發生錯誤。原因碼會指出錯誤原因：

1

無法登錄服務

2

無法設定必要的「使用者權限原則」

3

無法設定服務的「登入帳號」

4

無法刪除服務

解說

節點不存在，所以 DB2NDROP 失敗。

解說

節點已存在，所以 DB2NCRT 失敗。

解說

DB2NDROP 處理已成功地完成。

解說

DB2NCRT 處理已成功地完成。

解說

DB2NCHG 處理已成功地完成。

解說

指令只適用於實例是分割的資料庫實例。

解說

db2drvmp add     node_number
                                  from_drive to_drive
                 drop      node_number
                                     from_drive
       query     [node_number]
                 [from_drive]
       reconcile [node_number]
                 [from_drive]

解說

順利新增磁碟機對映。

解說

順利刪除磁碟機對映。

解說

參考訊息。

解說

吸收公用程式使用配送索引鍵來判斷分割區號碼，並將輸入記錄遞送至該分割區的其中一個清除程式。由於原因碼所指定的狀況，吸收公用程式會將記錄遞送至隨機清除程式。原因碼為：

1

NUM_FLUSHERS_PER_PARTITION 配置參數已設為 0，因此所有分割區只有 1 個清除程式。

2

目標表格是沒有配送索引鍵的類型。

3

至少其中一個配送索引鍵直欄，其具有的類型為使用者定義的類型 (UDT) 或 DB2SECURITYLABEL。

4

如果 SQL 陳述式為 INSERT 或 REPLACE，則直欄清單未指定所有配送索引鍵直欄。如果 SQL 陳述式為 UPDATE、DELETE 或 MERGE，則 WHERE 或 ON 子句未指定所有配送索引鍵直欄。

5

如果 SQL 陳述式為 INSERT 或 REPLACE，則 VALUES 清單中的值不是欄位名稱或常數。如果 SQL 陳述式為 UPDATE、DELETE 或 MERGE，則符合下列一個以上的狀況：

• 與配送索引鍵直欄的比較不是相等比較。
• 與配送索引鍵直欄比較的值不是欄位名稱或常數。
• 配送索引鍵直欄對應於多個欄位名稱或常數。

6

SQL 陳述式為 UPDATE、DELETE 或 MERGE，而且 WHERE 或 ON 子句的格式不是下列格式：

(dist-key-col1 = value1) AND (dist-key-col2 = value2) AND ... (dist-key-colN = valueN)

其中，dist-key-col1 至 dist-key-colN 包括所有配送索引鍵直欄，而且每一個值是一個欄位名稱或常數。

7

至少有一個配送索引鍵直欄具有數值類型，但其相對應的欄位沒有完全相同的數值類型，包括相同精準度及小數位數。

解說

吸收公用程式已順利完成，但傳回一些錯誤或警告。請參閱指定的訊息檔，以判斷這些錯誤或警告為何。

錯誤數包括公用程式無法從中回復的錯誤，但是不包括公用程式已從中回復的錯誤。

解說

吸收公用程式已順利完成，但傳回一些錯誤或警告。

錯誤數包括公用程式無法從中回復的錯誤，但是不包括公用程式已從中回復的錯誤。

解說

已順利完成 INGEST SET 或 INGEST 指令，但已置換使用者指定的配置參數。如果對 INGEST SET 指令發出此訊息，則在 CLP 階段作業的剩餘部分，此置換值都會維持有效。如果對 INGEST 指令發出此訊息，此置換值只會對 INGEST DATA 指令維持有效。

對應於原因碼的說明如下：

1

commit_count 及 commit_period 配置參數在相同的 INGEST 指令上無法設為 0。commit_period 已設為 1。

2

commit_count 配置參數必須設為 1000 的倍數，因此已進位到最接近 1000 的倍數。

3

已降低 commit_count 配置參數，因為鎖定清單或交易日誌已耗盡空間。新值是在鎖定清單或交易日誌耗盡空間之前，隨即確定的橫列數。

4

已降低 commit_period 配置參數，因為鎖定清單或交易日誌已耗盡空間。新值是前次確定的時間，與鎖定清單或交易日誌耗盡空間的時間之間的秒數。

10

因為符合下列其中一項，所以 num_flushers_per_partition 配置參數已調整為 0：

• 針對 UPDATE 作業，搜尋索引鍵中沒有適當的直欄，或搜尋索引鍵中的所有直欄同時也在更新索引鍵（在 SET 子句上指定）中。
• 針對 DELETE 作業，搜尋索引鍵中沒有適當的直欄。

搜尋索引鍵是下列形式的 WHERE 或 ON 子句上指定的所有直欄 c1、c2 等的集合：

(c1 = $field_1) AND (c2 = $field_2) 
    AND ... (cn = $field_n)
   [AND (<any other conditions<)]

（用方括弧括住的最後一個 AND 條件是選用的。）

11

因為表格的配送索引鍵中至少有一個直欄也在更新索引鍵（在 SET 子句上指定）中，所以分割的資料庫環境中的 num_flushers_per_partition 配置參數已調整為 0。

12

因為沒有索引至少包含一個在搜尋索引鍵（在 WHERE 子句上指定）中但不在更新索引鍵（在 SET 子句上指定）中的直欄，所以 num_flushers_per_partition 配置參數已調整為 1。

14

num_flushers_per_partition 配置參數已調整為 max_connections 資料庫管理程式配置參數的值，因為它不能大於 max_connections。

15

num_flushers_per_partition 配置參數已調整為 floor(128/（成員數）)，因為目標表格為直欄組織表格。直欄組織表格已結構化，如此當對所有成員採用總計 128 個平行插入執行緒時，即會達到最大吸收效能。

16

num_flushers_per_partition 配置參數已調整為 50，因為目標表格是直欄組織表格。直欄組織表格具結構化，因此使用 50 個平行插入執行緒時即達到吸收效能上限。

解說

指定欄位的值，超過欄位的長度。已截斷該值。例如，如果欄位定義為 CHAR(3)，但值為 "ABCDEF"，則會將值截斷為 "ABC"。

解說

此訊息對以下列出的訊息，提供識別發生錯誤的行號及輸入檔。

表格是在 INGEST 指令的 SQL 陳述式上所指定的表格，或是異常狀況表格。如果表格是在 SQL 陳述式上所指定的表格，SQL 陳述式是 INSERT 或 REPLACE，而且 INGEST 指令已指定異常狀況表格，則吸收公用程式會嘗試將記錄插入異常狀況表格。否則，吸收公用程式會捨棄記錄。

解說

此訊息對以下列出的訊息，提供識別發生錯誤的行號及輸入管道。

表格是在 INGEST 指令的 SQL 陳述式上所指定的表格，或是異常狀況表格。如果表格是在 SQL 陳述式上所指定的表格，SQL 陳述式是 INSERT 或 REPLACE，而且 INGEST 指令已指定異常狀況表格，則吸收公用程式會嘗試將記錄插入異常狀況表格。否則，吸收公用程式會捨棄記錄。

解說

此訊息對以下列出的訊息，提供識別發生錯誤的行號及輸入 TCP/IP 埠。

表格是在 INGEST 指令的 SQL 陳述式上所指定的表格，或是異常狀況表格。如果表格是在 SQL 陳述式上所指定的表格，SQL 陳述式是 INSERT 或 REPLACE，而且 INGEST 指令已指定異常狀況表格，則吸收公用程式會嘗試將記錄插入異常狀況表格。否則，吸收公用程式會捨棄記錄。

解說

此訊息對以下列出的訊息，提供識別發生錯誤的輸入管道。

解說

此訊息對以下列出的訊息，提供識別發生錯誤的輸入 TCP/IP 埠。

解說

當您在某個欄位上指定修飾元時，必須也在具有類似類型的所有欄位上指定修飾元。例如：如果小數欄位指定 RADIX POINT，則必須在所有其他 INTEGER、DECIMAL、DECLFOAT 及 FLOAT 欄位上也指定相同的 RADIX POINT 字元。如果在 DATE 欄位上指定格式字串，則必須在所有其他 DATE 欄位上也指定相同的格式字串。如果 INTEGER 欄位指定 EXTERNAL，則必須在所有其他 INTEGER、DECFLOAT 及 FLOAT 欄位上也指定 EXTERNAL。（不過，類型為 DECIMAL 的欄位，可以指定 PACKED 或 ZONED。但類型為 DECIMAL 的所有欄位，則必須與所有其他 DECIMAL 欄位一樣指定相同的 EXTERNAL、PACKED 或 ZONED 修飾元。）

解說

INGEST 指令指定二進位欄位類型，但輸入檔格式不是 POSITIONAL。指令失敗。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。如果有任何輸入欄位為二進位資料類型，則必須使用 INGEST 指令或 db2Ingest API 呼叫，來指定那些二進位欄位的長度。

嘗試吸收包含二進位欄位的資料，但未指定那些二進位欄位的長度時，即會傳回此訊息。

解說

指定 FORMAT POSITIONAL 的 INGEST 指令，必須指定或暗示欄位長度，或者 POSITION 參數必須指定結束位置。指令失敗。

解說

吸收公用程式正在啟動。工作 ID 是指定在 RESTART 參數上的 ID，如果未指定，則為公用程式產生的預設工作 ID。當 INGEST 指令在執行中時，工作 ID 可用於 INGEST GET STATS 指令。如果 INGEST 指令失敗，工作 ID 可用於後來的 INGEST 指令（其含有 RESTART CONTINUE 或 RESTART TERMINATE 參數）。

解說

RECORDLEN 在 INGEST 指令上指定的長度，必須大於或等於每一個欄位定義上指定的欄位長度總計。指令失敗。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。若要控制吸收公用程式修改目標表格的方式，請使用 INGEST 指令或 db2Ingest API 呼叫來指定 SQL 陳述式。

嘗試利用未參照任何欄位的 SQL 陳述式來執行吸收作業時，即會傳回此訊息。

解說

設定 SHM_MAX_SIZE 吸收公用程式配置參數，就可以指定「進程間通訊 (IPC)」共用記憶體的大小上限。

吸收作業因 SHM_MAX_SIZE 配置參數不足而失敗時，即會傳回此訊息。

解說

因為關鍵字組合無效，INGEST 指令失敗。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。您可以將資料串流至多個表格類型，包括下列範例：

• 多維叢集表格
• 具體化查詢表格
• 分割的表格
• 其他

嘗試將資料吸入吸收公用程式不支援的表格類型中時，即會傳回此訊息。

解說

如果 INGEST 指令所指定的 SQL 陳述式使用 WHERE 或 ON 子句，則必須包括至少指定一個欄位的搜尋條件。指令失敗。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。您可以說明分隔資料的欄位，在吸收公用程式中指定如何在輸入串流中定義資料。

嘗試利用參照的資料欄位不存在於輸入來源資料中的 SQL 陳述式來執行吸收作業時，即會傳回此訊息。

解說

此訊息對以下列出的訊息，提供識別發生錯誤的輸入檔。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。當呼叫吸收作業時，您可以指定輸入欄位的資料類型。

指定無效的欄位類型時，即會傳回此訊息。

解說

指定 DEFAULTIF 參數的欄位，無法在述詞或表示式中使用。指令失敗。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。您可以使用 DEFAULTIF 參數，每當某特定字元出現在輸入資料時，吸收公用程式即會將預設值插入目標表格中。

如果 DEFAULTIF 參數已與欄位定義一起指定，則對應於該欄位的直欄必須具有預設值。

當指定 DEFAULTIF 參數，但相對應的目標表格直欄沒有預設值時，即會傳回此訊息。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。您可以使用 DEFAULTIF 參數，每當某特定字元出現在輸入資料時，吸收公用程式即會將預設值插入目標表格中。

如果 DEFAULTIF 參數已與吸收公用程式一起指定，則相對應目標表格直欄的預設值必須是常數或 NULL。

當指定 DEFAULTIF 參數，但相對應目標表格直欄的預設值既不是常數也不是 NULL 時，即會傳回此訊息。

解說

可能是資料類型不符，因為指定欄位中的值無法轉換為欄位的資料類型。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。

嘗試呼叫吸收公用程式，但指定的輸入來源不是檔案或具名管道時，即會傳回此訊息。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。

當吸收公用程式無法開啟、讀取或關閉指定的輸入檔或具名管道時，即會傳回此訊息。

解說

吸收公用程式在指定的嘗試次數之後，無法配置進程間通訊 (IPC) 資源。資源類型可能為下列其中一項：

1. 共用記憶體
2. 接聽器佇列
3. 號誌

通常會先出現指出嘗試配置資源時發生錯誤的較早訊息，然後才顯示此訊息。

解說

INGEST 指令失敗。

如果參數為 PIPE_TIMEOUT，INGEST 指令在指令開啟管道之後，其至少指定的秒數內無法從管道接收任何資料。

解說

INGEST 指令中指定的（或解析的）埠號，必須在允許的範圍內。INGEST 指令失敗。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。當呼叫吸收作業時，您可以指定內容，例如輸入欄位的資料類型或長度。

當欄位值的長度超過已定義的欄位長度時，將截斷此值。例如，如果欄位定義為 CHAR(3)，但值為 "ABCDEF"，則會將值截斷為 "ABC"。

當輸入欄位值的長度超過已定義的欄位長度時，即會傳回此訊息。

解說

INGEST 指令無法使用該埠，因為其他執行中應用程式正在使用該埠。INGEST 指令失敗。

解說

INGEST 指令已指定 DEFAULTIF 子句，但輸入檔格式不是 POSITIONAL。指令失敗。

解說

基於下列原因碼所指出的原因，在輸入不具定界字元的 ASCII 檔內尋找指出的資料庫直欄的輸入資料時，欄位規格無效。

1

起始位置是 0。

2

結束位置小於起始位置。

3

結束位置大於 32 767。

4

類型為 SMALLINT、INTEGER、BIGINT、DECIMAL、REAL、FLOAT 及 DECFLOAT 且含有 EXTERNAL 修飾元的欄位，其長度上限為 50。

5

如果針對類型為 DATE、TIME 及 TIMESTAMP(p) 的欄位指定格式字串，則欄位長度必須大於或等於符合格式字串的最短值的長度。

6

如果未指定格式字串：

• 若為 DATE 欄位，欄位長度必須介於 8 與 10（包括這兩個數字）之間。
• 若為 TIME 欄位，欄位長度必須介於 4 與 8（包括這兩個數字）之間。
• 若為 TIMESTAMP 欄位，欄位長度必須介於 19 與 32（包括這兩個數字）之間。

INGEST 指令失敗。

解說

所指出指令參數的現行值無效，因為它超出允許的範圍。

指令失敗。

解說

吸收公用程式不支援將資料吸收至表格，這些表格的資料庫伺服器版本早於訊息中顯示的版本。

解說

欄位定義上的欄位類型指定無效的長度、精準度或小數位數。此錯誤的範例如下：

• 指定 CHAR(70000) 的欄位定義無效，因為欄位的長度上限為 32767。

解說

欄位定義指定 DEFAULTIF 時，只能將欄位指派給一個直欄，而且欄位不可是指派給該直欄之表示式的一部分。例如，請考量下列 INGEST 指令：

INGEST FROM FILE my_file.txt FORMAT DELIMITED
  ...
  UPDATE my_table
  SET (c1, c2, c3, c4, c5) =
      ($field1, $field2, $field2, 
          $field3, $field4+$field5) 
  WHERE $field3 = 1;

只有 $field1 可以指定 DEFAULTIF。$field2 已指派給多個直欄，因此無法指定。$field3 也在述詞中使用，因此無法指定。$field4 及 $field5 在表示式中使用，因此無法指定。

解說

下列一項成立時，吸收公用程式無法插入或更新表格：

• INGEST 指令上的 SQL 陳述式為 INSERT（屬於 MERGE 陳述式的一部分），而且下列其中一項成立：
  • 在表格名稱之後指定的所有直欄都定義為 GENERATED ALWAYS。
  • 在表格名稱之後未指定任何直欄，但所有表格的非隱藏直欄都定義為 GENERATED ALWAYS。
• INGEST 指令上的 SQL 陳述式為 UPDATE（屬於 MERGE 陳述式的一部分），而且 SET 子句上指定的所有直欄都定義為 GENERATED ALWAYS。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。若要控制吸收公用程式修改目標表格的方式，請使用 INGEST 指令或 db2Ingest API 呼叫來指定 SQL 陳述式。

當吸收公用程式與沒有 VALUES 子句的 INSERT 陳述式搭配使用時，欄位數目必須與所指定或暗示的表格直欄數目相同。（所暗示的直欄數目即是表格中非隱藏的直欄數目。）

例如，下列 INGEST 指令無效，因為指定兩個欄位，但有三個直欄：

INGEST FROM FILE my_file.del FORMAT DELIMITED
  ($field1 INTEGER EXTERNAL, $field2 CHAR(32))
  INSERT INTO my_table(col1, col2, col3);

解說

當 INGEST 指令指定 FORMAT DELIMITED 時，每一個類型為 DB2SECURITYLABEL 的欄位必須指定 NAME 或 STRING 修飾元。

解說

只有為定界格式時，INGEST 指令才能省略欄位清單。若為位置格式，則必須指定欄位清單。

解說

指令失敗，因為找不到具有指定 ID 的吸收工作。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。對於吸收公用程式支援的資料類型有些限制。

嘗試將資料吸入不受支援資料類型的直欄中時，即會傳回此訊息。

解說

在此訊息之前，會有一則識別輸入來源名稱及行號的訊息。所指定輸入記錄中的其中一個欄位對於表格直欄來說太長或超出範圍。

解說

吸收至可更新視圖，而且該視圖具有多個基本表格時，所有受到安全原則保護的基本表格都必須受到相同安全原則的保護。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。安全管理者可以使用安全原則來定義準則，以判定對表格的個別橫列及個別直欄具有寫入權及讀取權的人員。

嘗試將資料吸入受安全原則保護的表格中，但是型錄視圖 SYSCAT.SECURITYPOLICIES 沒有該 ID 的安全原則時，即會傳回此訊息。

解說

INGEST 指令上的 INPUT CODEPAGE 參數指定因下列其中一個原因，而無法使用的字碼頁號碼：

• 號碼不是有效的字碼頁。
• DB2 或 INGEST 指令不支援字碼頁。
• 字碼頁與用戶端字碼頁不相容。

解說

可能是資料類型不符，因為指定位元組位置欄位值轉換為欄位的資料類型。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。您可以針對吸收的資料指定欄位定義的清單，但是可以指定的欄位定義數目有一個上限。在執行時期記號 maximum-number 中，提供可容許的欄位定義數目上限。

嘗試指定比吸收公用程式可支援還要多的欄位定義時，即會傳回此訊息。

解說

找不到吸收公用程式需要的檔案。DB2 Data Server 用戶端或 DB2 Data Server Runtime 用戶端的安裝作業可能不完整或已損壞。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。您可以將 db2IngestStruct、db2IngestCfgList 及 db2IngestFormat 之類的資料結構傳遞至 db2Ingest API 呼叫，在吸收公用程式中指定如何在輸入串流中定義資料。

對其中一個輸入資料結構中的欄位指定無效的值時，即會傳回此訊息。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。如果吸收公用程式在完成之前失敗，您可以從前次確定點重新啟動吸收作業。若要讓吸收作業可以重新啟動，必須在起始吸收作業之前，建立重新啟動日誌表格。

嘗試重新啟動吸收公用程式，但吸收公用程式找不到重新啟動日誌表格時，即會傳回此訊息。

解說

INGEST 指令已指定 RESTART CONTINUE。若要重新啟動失敗的 INGEST 指令，重新啟動的指令必須符合下列需求：

• NUM_FLUSHERS_PER_PARTITION 配置參數必須與原始指令相同。
• 如果從檔案或管道進行輸入，輸入檔或管道的數目必須與原始指定相同。

解說

吸收公用程式在此訊息之後收到錯誤，但已透過發出 COMMIT 或 ROLLBACK 並重新發出 SQL 陳述式，而從錯誤中回復。公用程式已使用訊息中指定的次數，重新發出陳述式。原因碼指出公用程式如何從錯誤中回復：

1

公用程式透過在 Ingest 配置參數 COMMIT_PERIOD 或 COMMIT_COUNT 所要求的時間之前發出 Commit 來回復。對於此原因碼，重新連線數目和重試次數是 "0"。

2

公用程式透過發出 ROLLBACK 並重新連接或重試指定的次數來回復。

解說

欄位定義指定 DB2SECURITYLABEL STRING，但輸入來源中相對應欄位的值不是有效的安全標籤字串。未載入此橫列。

解說

INGEST 指令的輸入檔名稱或管道名稱數目超過所允許的數目，因此失敗。

解說

符合下列所有項目時，吸收公用程式會發出此訊息：

• INGEST 指令會省略 RESTART 參數，或是指定 RESTART NEW 或 RESTART CONTINUE。
• 目標表格是暱稱。
• 嘗試插入至或更新暱稱時，公用程式會收到原因碼為 18 的訊息 SQL30090N。

因為公用程式需要更新暱稱所參照的遠端表格以及本端重新啟動日誌表格，所以發生 SQL30090N 錯誤。這需要兩段式確定通訊協定，但是未在伺服器選項 DB2_TWO_PHASE_COMMIT 設為 'Y' 的情況下定義含有暱稱的伺服器定義。

解說

您可以使用 INGEST 指令，將資料從輸入檔或管道吸收至資料庫表格。您可以搭配使用 POSITIONAL 參數與 INGEST 指令，來指定每一個輸入記錄是一系列的文字或二進位欄位。您可以在欄位定義中使用 POSITION 子句，來指定記錄內每一個欄位的開始位置及結束位置。

當使用 POSITION 子句指定的開始位置或結束位置無效時，即會傳回此訊息。

解說

INGEST 指令會指定目前正在使用中的工作 ID，如原因碼所指出：

1

指令指定 RESTART NEW、RESTART CONTINUE 或 RESTART TERMINATE，但是具有所指定工作 ID 的 INGEST 指令已在執行中。

2

指令指定 RESTART NEW，但是重新啟動表格 (SYSTOOLS.INGESTRESTART) 已包含具有所指定工作 ID 的 INGEST 指令。

解說

此訊息識別發生下列訊息中的錯誤時正在操作的表格。如果表格是重新啟動表格 (systools.ingestrestart)，則重新啟動表格可能毀損、損壞或遺漏。

解說

如果吸收公用程式連接至資料庫，而且接收到警告或錯誤，則公用程式會發出這則訊息，後面接著警告或錯誤訊息。如果您已連接但未明確指定使用者 ID，則 user-ID 欄位是空的。

解說

如果吸收公用程式是在 DPF 環境中執行，而且可以判斷每個目標表格的配送索引鍵值，則會直接連接至每個資料庫分割區。如果公用程式連接至資料庫分割區，並收到警告或錯誤，則公用程式會發出這則訊息，而後面接著此警告或錯誤訊息。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。您可以說明分隔資料的欄位，在吸收公用程式中指定如何在輸入串流中定義資料。

當所指定輸入記錄中的其中一個欄位具有非數值，但卻預期該欄位應為數值時，即會傳回此訊息。

解說

在分割的資料庫環境中，公用程式會檢查對映到配送索引鍵直欄的欄位值，並使用那些值來決定記錄要傳送至的分割區。當欄位值對於相對應的配送索引鍵直欄類型而言無效或超出其範圍時，公用程式會發出此訊息。例如，如果配送索引鍵直欄類型是 INTEGER，但欄位包含 "ABC"，則公用程式會發出此訊息。直欄類型是對應於該欄位的配送索引鍵直欄的類型。直欄長度是直欄的長度（以位元組為單位）。

公用程式不會將記錄傳送至 DB2。如果指定 DUMPFILE 參數，公用程式會將記錄寫入傾出檔案中。

解說

資料庫目錄包含指定的資料庫的項目，但該項目指定的節點並不存在。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。您可以將 db2IngestStruct、db2IngestCfgList 及 db2IngestFormat 之類的資料結構傳遞至 db2Ingest API 呼叫，在吸收公用程式中指定如何在輸入串流中定義資料。

部分 db2Ingest 輸入結構的欄位包含物件的陣列：

• db2IngestFormat 結構的第一個欄位為 db2IngestFieldDefn 物件的陣列。
• db2IngestCfgList 結構的第一個欄位為 db2IngestCfgParam 物件的陣列。

物件陣列中的某個物件含有無效的欄位值時，即會傳回此訊息。執行時期記號 index-number 指出物件陣列中有問題的元素。索引開始於零。

解說

嘗試重新啟動吸收作業，但下列一項以上成立時，即會傳回此訊息：

實務範例 1：目標表格及重新啟動日誌表格 (SYSTOOLS.INGESTRESTART) 位於不同的表格空間中，但兩個表格空間是在不同的產品程式層次中。

實務範例 2：重新啟動日誌表格中屬於所指定吸收工作 ID 的記錄，已在吸收公用程式外進行修改。

實務範例 3：重新啟動的吸收作業的輸入檔或管道，未依原始指令的輸入檔或管道的相同順序提供相同記錄。

實務範例 4：下列一個以上的參數與原始吸收作業不同：

• SQL 陳述式。
• 欄位定義清單，包括欄位數目及所有欄位屬性。

實務範例 5：SQL 指令更新的一個以上目標表格直欄的定義，與它們在原始吸收作業時所擁有的定義不同。

實務範例 6：在多個資料庫分割區環境中：

• 自從執行原始吸收作業後，已新增或移除資料庫分割區。
• 自從執行原始吸收作業後，已跨分割區重新配送資料。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。當輸入串流中的欄位為日期、時間或時間戳記時，您可以提供格式字串來指定欄位的格式。

當欄位定義指定無效的日期、時間或時間戳記格式字串時，即會傳回此訊息。

解說

您可以使用吸收公用程式，將檔案及管道中的資料串流至 DB2 資料庫表格。如果吸收公用程式在完成之前失敗，您可以從前次確定點重新啟動吸收作業。

當起始設定吸收作業期間失去主要資料庫連線時，即會傳回此訊息。

解說

RECONNECT_COUNT Ingest 配置參數是設為大於 0 的值，而且 INGEST 指令會省略 RESTART 參數（因此它預設為 NEW），或者指定 RESTART NEW 或 RESTART CONTINUE。

解說

欄位長度及欄位結束位置之間發生衝突。指出的原因碼說明此衝突以及公用程式如何解決它：

1

欄位類型是二進位的 SMALLINT、INTEGER 或 BIGINT。（結束位置）-（起始位置）+ 1 所指定的長度是 2、4 或 8，但是不符合欄位類型的長度。公用程式將使用指定的結束位置。

例如，如果欄位定義是 SMALLINT POSITION(1:4)，則公用程式將讀取 4 個位元組（即使 SMALLINT 是 2 個位元組也一樣）。如果欄位包含 SMALLINT 範圍以外的值，當公用程式嘗試將欄位值轉換成 SMALLINT 時將發出錯誤。

2

欄位類型是二進位的 SMALLINT、INTEGER 或 BIGINT，但是（結束位置）-（起始位置）+ 1 所指定的長度不是 2、4 或 8。公用程式將調整結束位置，以符合欄位類型的長度。

例如，如果欄位定義是 SMALLINT POSITION(1:3)，則公用程式會將結束位置調整為 2（因為 SMALLINT 是 2 個位元組）。

3

欄位類型是二進位的 DECIMAL、REAL、FLOAT 或 DECFLOAT，但是（結束位置）-（起始位置）+ 1 所指定的長度與欄位類型的長度衝突。公用程式將調整結束位置，以符合欄位類型的長度。

例如，如果欄位定義是 REAL POSITION(1:5)，公用程式會將結束位置調整為 4（因為 REAL 是 4 個位元組）。

4

欄位類型上所指定的欄位長度與「（結束位置）-（起始位置）+ 1」衝突。如果指定的長度超出「（結束位置）-（起始位置）+ 1」，則公用程式會將長度調整為「（結束位置）-（起始位置）+ 1」。如果指定的長度小於（結束位置）-（起始位置）+ 1，公用程式會將結束位置調整為（起始位置）+ 長度 - 1。

例如，如果欄位定義是 CHAR(10) POSITION(1:8)，公用程式會將長度調整為 8。如果欄位定義是 CHAR(8) POSITION(1:10)，公用程式會將結束位置調整為 8。

解說

公用程式接收到錯誤而無法繼續執行。公用程式將結束。

在此錯誤之前已確定的橫列會保留在表格中。

解說

Ingest 配置參數 RECONNECT_COUNT 或 RETRY_COUNT 的值大於 0，而且公用程式接收到可回復的錯誤。公用程式嘗試從錯誤中回復，但是基於原因碼指出的原因而無法回復：

1

重新連接的嘗試次數已達到 RECONNECT_COUNT Ingest 配置參數的值。

2

重試次數已達到 RETRY_COUNT Ingest 配置參數的值。

3

公用程式遭岔斷或發生終止錯誤。

解說

吸收公用程式在指出的時間戳記啟動。公用程式也會發出指出工作 ID 的訊息。

解說

吸收公用程式已完成，而且沒有警告或錯誤。

解說

在呼叫作業系統函數或指令時發生非預期的錯誤。原因碼為：

1

在 /usr/bin 或 /bin 中找不到指令。對於原因碼，訊息中的「其他記號」欄位為空白。

2

函數或指令失敗，而且系統錯誤碼顯示在訊息的「其他記號」欄位中。在 UNIX 上，錯誤碼是定義在系統標頭檔 errno.h 中。如需 Windows 錯誤碼的相關資訊，請參閱 Microsoft 文件。

3

函數或指令未以預期的格式傳回輸出。訊息的「其他記號」欄位會顯示最後一行的輸出。

解說

您可以使用 INGEST LIST 指令或 INGEST GET STATS 指令，監視已連接至資料庫的授權 ID 正在執行的吸收作業進度。

當發出 INGEST LIST 指令或 INGEST GET STATS 指令，但目前連接至資料庫的授權 ID 未在現行機器上執行任何吸收作業時，即會傳回此訊息。如果授權 ID 最近從另一個階段作業啟動吸收作業，則該指令可能尚未完成起始設定或可能已完成。