PolarDB:ケース非依存性

識別子の折りたたみ動作

Oracle と PolarDB は、引用符なしの識別子を異なる方法で処理します。

両データベースは、二重引用符付き識別子を記述されたとおりに正確に格納します。これは、Oracle で test_table として作成されたテーブルがストレージでは TEST_TABLE になることを意味しますが、PolarDB で同じステートメントを実行すると test_table が生成されます。そして、"TEST_TABLE" を使用するクエリは、test_table と TEST_TABLE が同じではないため、PolarDB では失敗します。

ケース非依存性機能は、次の3つの識別子形式を同等にすることで、この問題を解決します。

有効にすると、これら4つのクエリはすべて同じ結果を返します。

SELECT * FROM test_table WHERE "ID" = 10;
SELECT * FROM "TEST_TABLE" WHERE "ID" = 10;
SELECT * FROM TEST_TABLE WHERE "ID" = 10;
SELECT * FROM "test_table" WHERE "ID" = 10;

サポートされるオブジェクト

ケース非依存性は、以下のすべてのオブジェクトタイプに適用されます。個々のオブジェクトタイプに対して有効にすることはできません。すべてに適用されるか、まったく適用されません。

• データベース

• スキーマ

• テーブル (共通テーブル式 (CTEs)、インデックス、ビュー、マテリアライズドビューを含む)

• カラム

• エイリアス

• 関数 (リビジョンバージョン 2.0.14.26.0 以降)

• パッケージ

ケース非依存性の有効化または無効化

polar_case_sensitive_for_columnref パラメーターを設定して、この機能を制御します。

コンソール経由: ご利用のクラスターのパラメーター設定に移動し、polar_case_sensitive_for_columnref を更新します。

SQL経由:

-- 有効化
SET polar_case_sensitive_for_columnref = on;

-- 無効化
SET polar_case_sensitive_for_columnref = off;

注意事項

既存のクラスターで有効にする前に:

マイナーバージョン 1.1.24 (2022年7月リリース) より前に作成されたクラスターの場合、データベース、スキーマ、テーブル、またはカラムのいずれかが、大文字と小文字のみが異なる名前 (たとえば、id という名前のカラムと ID という名前の別のカラム) を使用しているかどうかを確認してください。このようなクラスターでこの機能を有効にすると、エンジンがこれらの名前を区別できなくなるため、不正確なクエリ結果を返す可能性があります。

曖昧なオブジェクト名を避ける:

名前が文字ケースのみで異なるオブジェクトの命名は避けてください。クエリに、大文字と小文字が異なる同じ文字を持つカラムを持つテーブルが含まれる場合は、<table_name>.<column_name> 表記またはカラムエイリアスを使用してください。

CREATE TABLE "tbl" (id int);
DROP TABLE "TBL";  -- "tbl" と "TBL" の両方を削除します

例

CREATE TABLE "TEST_TABLE"(id int);
INSERT INTO test_table VALUES(10);

SELECT "T".id FROM "TEST_TABLE" AS t WHERE "ID" = 10;

 id
----
 10
(1 row)

CREATE DATABASE test_database;
\c test_database
CREATE SCHEMA "TEST_SCHEMA";
CREATE FUNCTION "TEST_SCHEMA"."TEST_FUNCTION"(IN i int) RETURNS int AS $$ BEGIN RETURN i; END; $$ LANGUAGE plpgsql;
SELECT "TEST_DATABASE".test_schema.test_function(10) FROM dual;

 test_function
---------------
            10
(1 row)

CREATE PACKAGE "TEST_PACKAGE" AS
    FUNCTION test_function(i int) RETURN int;
END;

CREATE PACKAGE BODY "TEST_PACKAGE" AS
    FUNCTION test_function(i int) RETURN int
    IS
    BEGIN
        RETURN i;
    END;
END;

SELECT test_package."TEST_FUNCTION"(100) FROM dual;

 TEST_FUNCTION
---------------
           100
(1 row)

CREATE TABLE "TEST_table"(id int);
SELECT * FROM "TEST_table" WHERE "ID" = 10;