// PostgreSQL エラーリファレンス

PostgreSQL 22001: 型に対して値が長すぎます

文字列が列の varchar(n) または char(n) の上限より長くなっています。PostgreSQL は黙って切り詰めるのではなく、拒否します。

SQLSTATE
22001
名前
string_data_right_truncation
カテゴリ
データ例外
エラーメッセージ
value too long for type character varying(20)

意味

A varchar(n) または char(n) 列には最大n文字まで保持できます。それより長い値を挿入または更新すると22001で失敗します(string_data_right_truncation)。PostgreSQL が黙って切り詰めるのは、明示的にキャストしたときだけです。たとえば 'abcdef'::varchar(3)、SQL 標準で要求されています。

メッセージには型の名前は示されますが、列の名前は示されないため、長さに制限のある列が複数ある場合は、どの値が長すぎるかを確認する必要があります。

よくある原因

  • 列の定義より長い、ユーザー入力またはインポートされたデータ。
  • 複数列の INSERT 値の順序が列リストと異なり、長い値が短い列に入ってしまう場合。
  • 制限の厳しい別のデータベースから移行されたスキーマ。

修正方法

  1. 値の長さを上限と比較して、オーバーフローした列を見つけます。

    SELECT column_name, character_maximum_length
    FROM information_schema.columns
    WHERE table_name = 'customers' AND character_maximum_length IS NOT NULL;
  2. 列を広げるか、次を使用してください text、長さの制限がなく、次と同じように動作します varchar.

    ALTER TABLE customers ALTER COLUMN name TYPE varchar(200);
    -- or
    ALTER TABLE customers ALTER COLUMN name TYPE text;
  3. 切り捨てを許容できる場合は、明示的に行ってください。

    INSERT INTO customers (name) VALUES (left('a very long name ...', 20));

安全に再現する

SELECT CAST('abc' AS varchar(2)) AS silently_truncated;
CREATE TEMP TABLE t (code varchar(2));
INSERT INTO t VALUES ('abc');  -- ERROR: value too long for type character varying(2)

質問

PostgreSQL では text 型は varchar より遅いですか?

いいえ。text と varchar は同じストレージを使います。長さ制限はパフォーマンス機能ではなく、データに対する制約です。

関連エラー

その他のデータ例外のエラー

コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で PostgreSQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。