Oracle®Developersリファレンス・ガイドのデータベース互換性

 

 

 

EDB Postgres™Advanced Server 11

2018年11月20日

 

 

 

 

1 はじめに

オラクルの データベース互換性とは、アプリケーションがOracle環境だけでなく、 EDB Postgres Advanced Server（Advanced Server）環境で動作し、アプリケーションコードをほとんど変更しないか、またはまったく変更しないことを意味します。

このガイドでは、Advanced Serverの互換性機能に関する参考資料を提供しています。

•	SQL言語構文サポート

•	互換性のあるデータ型

•

SQLコマンド

•

カタログビュー

•	システムカタログテーブル

Advanced Server でOracleデータベースと互換性の ある アプリケーションを 開発するには、アプリケーションの構築にどの機能が使用されているかを特に注意する必要があります。たとえば、 互換性のあるアプリケーションを開発するとは、

•	Oracleデータベースと互換性のあるアプリケーションのデータベース表を定義するデータ型

•	Oracle SQLと互換性のあるSQL文

•	Oracleデータベースと互換性のあるSQL文およびプロシージャー・ロジックで使用するためのシステムおよび組み込み関数

•	ストアドプロシージャ 、関数、トリガ、およびパッケージ用のデータベースサーバー側アプリケーションロジックを作成するためのストアドプロシージャ言語 （ SPL ）

•	Oracleのデータ・ディクショナリと互換性のあるシステム・カタログ・ビュー

Advanced Serverの互換性機能と拡張機能の詳細については、Advanced Serverのドキュメントの完全なライブラリを参照してください。

https://www.enterprisedb.com/resources/product-documentation

1.1 新機能

Advanced Server 11を作成するために 、 Advanced Server 10に 以下の Oracle機能のデータベース互換性が追加されました。

•	Advanced Serverは、SPLスタンドアロンプ​​ロシージャのオーバーロードをサポートするようになりました。この機能はOracleデータベースと互換性がないことに注意してください。詳細は、 2.3.25 項を参照してください 。

•	Advanced Serverは、任意のSPLブロック内でPRAGMA AUTONOMOUS_TRANSACTION指示文を サポートし 、自律型トランザクション機能を提供するようになりました。詳細は、「 Oracle Developer's Guide」のデータベース互換性を参照してください。影響を受けたSPLプログラムでは、セクションを参照2.3.20 、 2.3.24 、 2.3.25 、 2.3.35 、および2.3.37を 。

1.2 このガイドで使用される表記規則

このマニュアルでは、さまざまなコマンド、文、プログラム、例などの意味と使用法を明確にするために、特定の表記規則が使用されています。このセクションでは、これらの規則の概要を説明します。

以下の説明では、 用語は、言語キーワード、ユーザ提供値、リテラルなどの任意の単語または単語群を指す。用語の正確な意味は、それが使用される文脈に依存する。

•	イタリック体のフォントで は、通常、最初に定義された文章に新しい用語が導入されています。

•	固定幅（単間隔）フォント は、 SQL コマンド、例で使用されている特定のテーブルとカラム名、プログラミング言語キーワード など、文字通り与えなければならない用語に使用され ます 。たとえば、 SELECT * FROM emp;

•	イタリック固定幅フォント は、ユーザーが実際の使用で値を置き換える必要がある用語に使用されます。たとえば、 DELETE FROM table_name ;

•	|パイプの両側の用語の間の選択を示します。垂直パイプは、角括弧（オプションの選択肢）または中括弧（1つの必須選択肢）内の2つ以上の代替用語を区切るために使用されます。

•	角括弧[]は、囲まれた用語の1つまたはいずれかが置換されている可能性があることを示します。たとえば、 [a | b]は 、「 a 」または「 b 」のいずれかを選択するか、またはどちらも選択しないことを意味します。

•	中括弧{}は、囲まれた選択肢のうちの1つを指定する必要があることを示します。たとえば、 {a | b}は 、 " a "または " b "のうちの1つを指定する必要があることを意味します。

•	楕円形...とは、進行中の用語を繰り返すことができることを意味します。たとえば、 [a | b] ...は、あなたがシーケンス「 baaba 」を持っているかもしれないことを意味します。

2 SQL言語

以下のセクションでは、 Oracleデータベースと互換性のある Advanced Server SQL言語のサブセットについて説明します。次のSQL構文、コマンド、データ型、および関数は、EDB Postgres Advanced ServerとOracleの両方で機能します 。

Advanced Serverのドキュメント・セットには、拡張機能（Oracleとのデータベース互換性を提供しない機能、またはOracleスタイルのアプリケーションをサポートしない機能）の構文とコマンドが含まれています。

このセクションは、次のセクションで構成されています。

•	Advanced Serverの SQL構文と言語要素の一般的な説明

•

データ型

•	SQLコマンドの要約

•

組み込み関数

2.1 SQL構文

このセクションでは、 SQL の一般的な構文について説明し ます 。これは、データを定義および変更するためにSQLコマンドがどのように適用されるかについての詳細を含む次の章を理解するための基礎を形成します。

 

2.1.1 字句構造

SQL入力は一連のコマンドで構成されています。 コマンドは、一連のトークンで構成され、セミコロン（;）で終了します。入力ストリームの終わりもコマンドを終了します。有効なトークンは、特定のコマンドの構文に依存します。

トークンは、 キーワード 、 識別子 、 引用符で囲まれた識別子 、 リテラル （ 定数 ）、または特殊文字シンボルです。トークンは通常、 空白 （スペース、タブ、 改行 ）で区切られますが、あいまいさがない場合（通常、特殊文字が他のトークンタイプに隣接している場合のみです）にする必要はありません。

さらに、 SQL入力で コメントが発生する可能性があります 。それらはトークンではなく、空白と事実上同等です。

たとえば、次の構文は有効な SQL入力です。

SELECT * FROM MY_TABLE;

UPDATE MY_TABLE SET A = 5;

INSERT INTO MY_TABLE VALUES (3, 'hi there');

これは一連の3つのコマンドで、1行に1つです（これは必須ではありませんが、複数のコマンドを1つの行に置くことができ、コマンドは通常行間に分割できます）。

SQL構文は、トークンがコマンドを識別し、オペランドまたはパラメータである何に関して非常に一貫していません。最初の数個のトークンは一般にコマンド名です。したがって、上記の例では、通常、 SELECT 、 UPDATE 、およびINSERTコマンドについて説明します。しかし、例えば、 UPDATEコマンドは常にSETトークンを特定の位置に表示する必要があります。この特定のINSERTバリエーションには、 VALUESトークンが必要です。各コマンドの正確な構文規則については、 2.3節で説明します。

 

2.1.2 識別子とキーワード

上の例のSELECT 、 UPDATE 、 VALUES などのトークンはキーワードの例です。つまり、 SQL言語で固定された意味を持つ単語です。トークンMY_TABLEとAは識別子の例です。それらは、使用されているコマンドに応じて、テーブル、列、または他のデータベースオブジェクトの名前を識別します。したがって、単に「 名前 」と呼ばれることもあります。キーワードと識別子は同じ字句構造を持ちます。つまり、言語を知らなくてもトークンが識別子かキーワードかどうかを知ることはできません。

SQLの識別子とキーワードは、文字（ azまたはAZ ）で始まる必要があります。識別子またはキーワードの後続の文字は、文字、アンダースコア、数字（ 0-9 ）、ドル記号（ $ ）、または数字記号（ ＃ ）です。

識別子とキーワード名は大文字と小文字を区別しません。したがって、

UPDATE MY_TABLE SET A = 5;

等価的に以下のように書くことができます：

uPDaTE my_TabLE SeT a = 5;

大抵の場合、大文字で大文字を、大文字では小文字で、

UPDATE my_table SET a = 5;

第2の種類の識別子： 区切られた識別子または引用された識別子 。二重引用符（ "）で任意の文字の並びを囲むことによって形成される。区切り識別子は常に識別子、キーワードではありません。だから、『『選択 』という名前の列やテーブルを参照するために使用できる』 を選択し 、引用符で囲まれていないselectはキーワードとして扱われるため、テーブルやカラムの名前が必要な場所で使用すると解析エラーが発生します。

UPDATE "my_table" SET "a" = 5;

引用符付きの識別子には、数字コード0の文字を除く任意の文字を含めることができます。

二重引用符を含めるには、二重引用符を二重に使用します。これにより、他の方法では使用できないテーブル名や列名（空白やアンパサンドを含むものなど）を作成することができます。長さの制限は依然として適用されます。

識別子をクォートすると、大文字と小文字が区別されますが、引用されていない名前は常に小文字に変換されます。たとえば、識別子 FOO 、 foo 、および"foo"は、 Advanced Serverでは同じと見なされますが、 "Foo"と"FOO"はこれらの3つのものと異なります。引用符のない名前を小文字に変換することは、Oracleデータベースと互換性がありません。 Oracleの構文では、引用符で囲まれていない名前は大文字に変換されます。たとえば、 fooは"foo" ではなく" FOO"に相当します 。ポータブルアプリケーションを作成する場合は、常に特定の名前を引用するか、引用しないことをお勧めします。

 

2.1.3 定数

Advanced Server の暗黙的に型指定された定数の種類は、 文字列と数値です。明示的な型で定数を指定することもできます。これにより、より正確な表現とシステムによる効率的な処理が可能になります。これらの選択肢については、次のサブセクションで説明します。

2.1.3.1 文字列定数

SQL の 文字列定数は、一重引用符（ ' ）で囲まれた文字の任意のシーケンスです（たとえば、 ' This is a string '） 。文字列定数の中に一重引用符を含めるには、二つの隣接する一重引用符（例えば、 'Dianne'の馬 ' ）を書いてください。これは二重引用符（ "）と同じではないことに注意してください。

2.1.3.2 数値定数

数値定数は、次の一般的な形式で受け入れられます。

digits

digits .[ digits ][e[+-] digits ]

[ digits ]. digits [e[+-] digits ]

digits e[+-] digits

ここで、 数字は、一つ以上の桁（0〜9）です。少なくとも1桁は、小数点が使用されている場合は、小数点の前または後にする必要があります。指数マーカー（ e ）が存在する場合は、少なくとも1桁は指数マーカーに従わなければなりません。定数にはスペースやその他の文字が埋め込まれていないことがあります。先頭のプラス記号またはマイナス記号は、実際には定数の一部とはみなされないことに注意してください。定数に適用される演算子です。

有効な数値定数の例をいくつか示します。

42
3.5
4.
.001
5e2
1.925e-3

小数点も指数も含まない数値定数は 、その値がINTEGER型（32ビット）に収まる場合は、最初は INTEGER 型であると推定されます 。そうでない場合は、その値が型BIGINT（64ビット）に収まる場合にタイプBIGINTであると推定されます。それ以外の場合はNUMBER型になります。小数点および/または指数を含む定数は、常に最初はNUMBER型とみなされます。

最初に割り当てられた数値定数のデータ型は、型解決アルゴリズムの出発点にすぎません。ほとんどの場合、定数はコンテキストに応じて自動的に最適な型に強制的に変換されます。必要に応じて、次のセクションで説明するように、数値をキャストして特定のデータ型として解釈させることができます。

2.1.3.3 他の型の定数

任意の型の定数は、次の表記法を使用して入力できます。

CAST(' string ' AS type )

文字列定数のテキストは、typeと呼ばれる 型の 入力変換ルーチンに渡されます 。結果は示された型の定数です。明示的な型キャストは、定数が（たとえば、それが直接的に表の列に割り当てられる）型でなければならない場合に、あいまいさがなければ省略できます。この場合、自動的に強制的に強制されます。

CASTは、任意の式の実行時の型変換を指定するためにも使用できます。

 

2.1.4 コメント

コメントは二重ダッシュで始まり、行の終わりまで続く文字の任意のシーケンスです。例：

-- This is a standard SQL comment

あるいは、 Cスタイルのブロックコメントを使用することもできます。

/* multiline comment

* block

*/

ここで、コメントは / *で 始まり 、 * /の一致する出現に及ぶ。

 

2.2 データ型

次の表は、組み込みの汎用データ型を示しています。

表2-1データ型

Name	Alias	Description
BLOB	LONG RAW, RAW( n ), BYTEA	Binary data
BOOLEAN		Logical Boolean (true/false)
CHAR [ ( n ) ]	CHARACTER [ ( n ) ]	Fixed-length character string of n characters
CLOB	LONG, LONG VARCHAR	Long character string
DATE	TIMESTAMP	Date and time to the second
DOUBLE PRECISION	FLOAT, FLOAT(25) – FLOAT(53)	Double precision floating-point number
INTEGER	INT, BINARY_INTEGER, PLS_INTEGER	Signed four-byte integer
NUMBER	DEC, DECIMAL, NUMERIC	Exact numeric with optional decimal places
NUMBER( p [, s ])	DEC(p [, s ]), DECIMAL( p [, s ]), NUMERIC( p [, s ])	Exact numeric of maximum precision, p , and optional scale, sの Exact numeric of maximum precision,
REAL	FLOAT(1) – FLOAT(24)	Single precision floating-point number
TIMESTAMP [ ( p ) ]		Date and time with optional, fractional second precision, pの Date and time with optional, fractional second precision,
TIMESTAMP [ ( p ) ] WITH TIME ZONE		Date and time with optional, fractional second precision, p , and with time zone Date and time with optional, fractional second precision,
VARCHAR2( n )	CHAR VARYING( n ), CHARACTER VARYING( n ), VARCHAR( n )	Variable-length character string with a maximum length of n characters Variable-length character string with a maximum length of
XMLTYPE		XML data

 

2.2.1 数値型

数値型は、4バイトの整数、4バイトと8バイトの浮動小数点数、および固定小数点の小数で構成されます。次の表に、使用可能なタイプを示します。

表2-2数値タイプ

Name	Storage Size	Description	Range
BINARY_INTEGER	4 bytes	INTEGER Signed integer, Alias for	-2,147,483,648 to +2,147,483,647
DOUBLE PRECISION	8 bytes	Variable-precision, inexact	15 decimal digits precision
INTEGER	4 bytes	Usual choice for integer	-2,147,483,648 to +2,147,483,647
NUMBER	Variable	User-specified precision, exact	Up to 1000 digits of precision
NUMBER( p [, s ] )	Variable	Exact numeric of maximum precision, p , and optional scale, sの Exact numeric of maximum precision,	Up to 1000 digits of precision
PLS_INTEGER	4 bytes	INTEGER Signed integer, Alias for	-2,147,483,648 to +2,147,483,647
REAL	4 bytes	Variable-precision, inexact	6 decimal digits precision
ROWID	8 bytes	Signed 8 bit integer.	-9223372036854775808 to 9223372036854775807

次のセクションでは、型の詳細について説明します。

2.2.1.1 整数型

タイプ INTEGERは 、-2,147,483,648と+2,147,483,647の値の間に（小数成分なしの）整数を格納します。許容範囲外の値を格納しようとすると、エラーが発生します。

ROWID型の列は、レコードの物理アドレスを記述する固定長バイナリ・データを保持します。 ROWIDは、0と4,294,967,295の値の間に（小数成分なしの）整数を格納する、符号なしの4バイトのINTEGERです。許容範囲外の値を格納しようとすると、エラーが発生します。

2.2.1.2 任意精度の数値

タイプ NUMBERは 、実質的に無制限の精度の桁数を格納し、正確に計算を実行できます。金額や正確さが必要な場合は他の数量を保管する場合に特にお勧めします。ただし、 NUMBER型は、次のセクションで説明する浮動小数点型に比べて非常に遅いです。

以下では、これらの用語を使用します 。NUMBER の 位取りは、小数点以下の小数点以下の小数点以下の桁数です。 NUMBERの精度は、整数の有効数字の合計数、つまり小数点の両側の桁数です。したがって、23.5141の数値は6の精度と4のスケールを持ちます。整数は0のスケールを持つとみなすことができます。

NUMBERタイプの精度と位取りの両方を設定できます。 NUMBER型の列を宣言するには、構文を使用します

NUMBER( precision , scale )

精度は正でなければならず、スケールはゼロまたは正でなければなりません。あるいは、

NUMBER( precision )

スケール0を選択し ます。精度または位取りを 指定し ないで NUMBER を 指定 すると、任意の精度および位取りの数値を精度の実装限界まで格納できる列が作成されます。このような列は入力値を特定のスケールに強制しません が、宣言されたスケールの NUMBER 列は入力値をそのスケールに強制します。 （ SQL標準では、デフォルトスケール0、すなわち整数精度への強制が必要です。移植性を最大限に高めるには、精度と位取りを明示的に指定することをお勧めします）。

値の精度または位取りが列の宣言された精度または位取りより大きい場合、システムは値を丸めようとします。宣言された制限を満たすように値を四捨五入することができない場合は、エラーが発生します。

2.2.1.3 浮動小数点型

データ型 REAL と DOUBLE PRECISION は、 不正確 で可変長の数値型です。実際には、これらのタイプは、通常 、基底のプロセッサ、オペレーティングシステム、およびコンパイラがサポートする範囲で、バイナリ浮動小数点演算（それぞれ単精度および倍精度） の IEEE 標準754の 実装です 。

不正確とは、一部の値を内部形式に正確に変換できず、値を保存して印刷する際にわずかな不一致が生じるように、近似値として格納されることを意味します。これらのエラーを管理し、計算をどのように伝播させるかは、数学とコンピュータサイエンスの全分野の主題であり、次の点を除いてここではこれ以上説明しません。

正確な保管と計算（金額など）が必要な場合は、代わりにNUMBERタイプを使用してください 。

これらの型を持つ複雑な計算を何か重要なものにする場合は、特に境界ケース（無限大、アンダーフロー）の特定の動作に頼っている場合は、実装を慎重に評価する必要があります。

平等のために2つの浮動小数点値を比較すると、期待どおりに動作する場合と動作しない場合があります。

ほとんどのプラットフォームでは、 REAL型は少なくとも1E-37〜1E + 37の範囲を持ち、精度は少なくとも6桁です。 DOUBLE PRECISIONタイプは通常、1E-307〜1E + 308の範囲で、少なくとも15桁の精度を持ちます。値が大きすぎたり小さすぎたりすると、エラーが発生します。入力番号の精度が高すぎる場合は、丸めが行われることがあります。 0に近い数値は、ゼロとは区別されて表現できないため、アンダーフローエラーが発生します。

Advanced Server は、 不正確な数値型を指定するため の SQL 標準表記 FLOAT および FLOAT（ p ） もサポートしてい ます 。ここで、 p は最小許容精度を2進数で指定します。 Advanced Server は 、 REAL タイプ を選択する場合 は FLOAT（1） から FLOAT（24） を、 DOUBLE PRECISION を選択する場合は FLOAT（25） から FLOAT（53） を 受け入れ ます 。 許容範囲外 の pの 値は エラーを引き起こします。 精度が指定されていない FLOAT は、 DOUBLE PRECISION を意味し ます。

2.2.2 文字の種類

次の表に、 Advanced Serverで使用可能な汎用文字の種類を示します 。

表2-3文字の種類

Name	Description
CHAR[( n )]	Fixed-length character string, blank-padded to the size specified by n Fixed-length character string, blank-padded to the size specified by
CLOB	Large variable-length up to 1 GB
LONG	Variable unlimited length.
NVARCHAR( n )	Variable-length national character string, with limit.
NVARCHAR2( n )	Variable-length national character string, with limit.
STRING	VARCHAR2 Alias for .
VARCHAR( n )	Variable-length character string, with limit (considered deprecated, but supported for compatibility)
VARCHAR2( n )	Variable-length character string, with limit

ここで、 n は正の整数です。これらの型は 長さ が n 文字までの文字列を格納できます 。 余分な文字がすべて空白でない限り、 n の長さを超える値を代入 するとエラーになります。この場合、文字列は最大長に切り捨てられます。

これらのタイプのデータの格納要件は、文字列が127バイト未満の場合は1バイト、文字列が127バイト以上の場合は4バイトです。 CHAR の場合 、パディングにも格納が必要です。長い文字列はシステムによって自動的に圧縮されるため、ディスク上の物理的な要件が少なくなる可能性があります。長い値は、短い列値への高速アクセスを妨げないように、バックグラウンド表に保管されます。

データベースの文字セットは、テキスト値を格納するために使用される文字セットを決定します。

CHAR

値を指定しない場合 n 、 n はデフォルトで 1に なります 。割り当てられる文字列が n よりも短い場合 、 CHAR 型の値は指定された幅（ n ）にスペースが埋め込まれ、そのように格納されて表示されます。

パディングスペースは、意味的に重要でないものとして扱われます。つまり、末尾のスペースは、 CHAR 型の2つの値を比較するときは無視され、 CHAR値を他の文字列型のいずれかに変換するときには削除されます。

オーバー長さの値を CHAR（ n ）型に明示的にキャストすると、 （ SQL標準で指定されているように）エラーを発生させずに値がn文字に切り捨てられます 。

VARCHAR、VARCHAR2、NVARCHARおよびNVARCHAR2

割り当てられる文字列が n より短い場合 、 VARCHAR 、 VARCHAR2 、 NVARCHARおよびNVARCHAR2 型の値は 、パディングなしで短い文字列を格納します。

末尾のスペース は VARCHAR値で意味的に重要であることに注意してください 。

VARCHAR型に明示的に値をキャストすると 、 SQL標準で指定されているように、エラーを発生させることなく長さの値がn文字に切り捨てられます 。

CLOB

CLOB型で大きな文字列を格納できます。長さの制限が指定されていないことを除いて、 CLOBはVARCHAR2と意味的に同等です。通常、最大文字列長がわからない場合は、 CLOB型を使用する必要があります。

CLOB型に格納できる最長文字列は約1 GBです。

注意： CLOBデータ型は、実際にはPostgreSQLのTEXTデータ型に基づくDOMAINです。 DOMAINの詳細については、PostgreSQLのコアドキュメントを参照してください。

https://www.postgresql.org/docs/11/static/sql-createdomain.html

したがって、 CLOBタイプの使用は、約1GBの最大サイズなどのTEXTに対して実行できる処理によって制限されます。

大量のデータを使用する場合は、 CLOBデータ型を使用する代わりに、 pg_largeobjectシステムカタログに依存するPostgreSQL ラージオブジェクト機能を使用してください。ラージオブジェクトの詳細については、PostgreSQLのコアドキュメントを参照してください。

https://www.postgresql.org/docs/11/static/largeobjects.html

 

2.2.3 バイナリデータ

次のデータ型では、バイナリ文字列を格納できます。

表2-4バイナリラージオブジェクト

Name	Storage Size	Description
BINARY	The length of the binary string.	Fixed-length binary string, with a length between 1 and 8300.
BLOB	The actual binary string plus 1 byte if the binary string is less than 127 bytes, or 4 bytes if the binary string is 127 bytes or greater.	Variable-length binary string, with a maximum size of 1 GB.
VARBINARY	The length of the binary string	Variable-length binary string, with a length betw een 1 and 8300.

バイナリ文字列は、オクテット（またはバイト）のシーケンスです。バイナリ文字列は、2つの特性によって文字列と区別されます。まず、バイナリ文字列は、値ゼロのオクテットと他の "印刷不可能" オクテット（32〜126の範囲外のオクテットとして定義）を 格納することを特に許可し ます。第2に、バイナリ文字列の操作は実際のバイトを処理しますが、文字列のエンコーディングと処理はロケール設定に依存します。

 

 

2.2.4 日付/時刻タイプ

次の日付/時刻タイプの説明では 、表が作成または変更されるたびに、構成パラメーター edb_redwood_dateがtrueに設定されていることを前提としています 。

Advanced Server は、次の表に示す日付/時刻タイプをサポートしています。

表2-5日付/時刻タイプ

Name	Storage Size	Description	Low Value	High Value	Resolution
DATE	8 bytes	Date and time	4713 BC	5874897 AD	1 second
INTERVAL DAY TO SECOND [( p )]	12 bytes	Period of time	-178000000 years	178000000 years	1 microsecond / 14 digits
INTERVAL YEAR TO MONTH	12 bytes	Period of time	-178000000 years	178000000 years	1 microsecond / 14 digits
TIMESTAMP [( p )]	8 bytes	Date and time	4713 BC	5874897 AD	1 microsecond
TIMESTAMP [( p )] WITH TIME ZONE	8 bytes	Date and time with time zone	4713 BC	5874897 AD	1 microsecond

場合 DATEは、 データ定義言語（DDL）コマンドの列のデータ・タイプとして表示され、 表を作成する か、 表を ALTER、それは、テーブル定義はデータベースに格納された時点でタイムスタンプ に変換されます 。したがって、時間成分も日付とともに列に格納されます。

とき DATEは、SPL宣言セクション、またはSPLプロシージャの仮パラメータまたはSPL関数のデータ型、またはSPL関数の戻り値の型で変数のデータ型として表示され、それは常にTIMESTAMPに変換されるので、存在する場合、時間成分を扱うことができる。

TIMESTAMP は 、秒フィールドに保持される小数点以下桁数を指定 するオプションの精度値 p を 受け入れ ます。 p の許容範囲は 0〜6で、デフォルトは6です。

場合 TIMESTAMP値は、倍精度浮動小数点数（現在のデフォルト）として保存され、精度の有効限界未満6 TIMESTAMP値は真夜中2000-01-01前または後秒として保存されてもよいです。マイクロ秒の精度は、2000年1月1日から数年以内の日付で達成されますが、日付の精度が低下します。 TIMESTAMP値が8バイト整数（コンパイル時のオプション）として格納される場合、マイクロ秒の精度がすべての値域にわたって使用可能です。ただし、8バイト整数のタイムスタンプの日付範囲は上記のものよりも限られています。紀元前4713年から294276年までです。

TIMESTAMP （ p ）WITH TIME ZONEはTIMESTAMP （ p ）に似ていますが、タイムゾーンも含みます。

2.2.4.1 インターバルタイプ

INTERVAL値は期間を指定します。 INTERVAL型の値は、データの値を記述するフィールドで構成されます。次の表は、 INTERVAL型で許可されるフィールドの一覧です。

表2-6間隔タイプ

Field Name	INTERVAL Values Allowed
YEAR	Integer value (positive or negative)
MONTH	0 through 11
DAY	Integer value (positive or negative)
HOUR	0 through 23
MINUTE	0 through 59
SECOND	0 through 59.9( p ) where 9( p ) is the precision of fractional seconds

フィールドは、 YEARSからMONTHSへ 、 DAYSからHOURS 、 MINUTES 、 SECONDSの 順に降順で表示する必要があります 。

Advanced Serverは 、Oracleデータベースと互換性のある2つの INTERVALタイプをサポートしています。

Advanced Serverでサポートされる最初のバリエーションは、 INTERVAL DAY TO SECOND [（ p ）]です。 INTERVAL DAY TO SECOND [（ p ）]は、時間間隔を日、時間、分、秒で格納します。

p は 2番目の フィールドの 精度を指定し ます。

Advanced Serverは次の値を解釈します。

INTERVAL '1 2：34：5.678'第2日まで（3）

1日、2時間、34分、5秒、および678分の1秒のように表示されます。

Advanced Serverは次の値を解釈します。

INTERVAL '1 23時間まで

1日23時間とします。

Advanced Serverは次の値を解釈します。

インターバル '2:34'時間

2時間34分とする。

Advanced Serverは次の値を解釈します。

INTERVAL '2：34：56.129'時間まで（2）

2時間34分56秒13000分の1秒とします。小数第2は、指定された精度のために13に切り上げられることに注意してください。

Oracleデータベースと互換性のあるAdvanced Serverでサポートされている2番目のバリエーションは、 INTERVAL YEAR TO MONTHです。このバリエーションは、時間間隔を年数および月単位で格納します。

Advanced Serverは次の値を解釈します。

月から12月までの間に'12 -3 '

12年3ヶ月として。

Advanced Serverは次の値を解釈します。

インターバル'456年（2）

12年3ヶ月として。

Advanced Serverは次の値を解釈します。

インターバル「300」月

25年として

2.2.4.2 日付/時刻入力

日付と時刻の入力は、ISO 8601の SQL 互換形式、 Oracleの デフォルトのdd-MON-yy形式、その他の形式 で受け入れられ ます。ただし、年、月、日のいずれのコンポーネントがあいまいでないかは不明です。ただし、あいまいさを避けるために、 TO_DATE関数の使用を強くお勧めします。

任意の日付または時刻のリテラル入力は、テキスト文字列のように単一引用符で囲む必要があります。次の SQL標準構文も使用できます。

type ' value '

type は DATE または TIMESTAMPの いずれか です。

value は日付/時刻テキスト文字列です。

2.2.4.2.1 日付

次の表は、日付の可能な入力形式の一部を示しています。これらはすべて1999年1月8日に相当します。

表2-7日付入力

Example

January 8, 1999

1999-01-08

1999-Jan-08

Jan-08-1999

08-Jan-1999

08-Jan-99

Jan-08-99

19990108

990108

日付値は、 DATE または TIMESTAMP 列または変数に 割り当てることができ ます。日付値に時間値が付加されていない場合、時、分、および秒フィールドはゼロに設定されます。

2.2.4.2.2 時間

次の表に、日付またはタイムスタンプの時間コンポーネントのいくつかの例を示します。

表2-8時間入力

Example	Description
04:05:06.789	ISO 8601
04:05:06	ISO 8601
04:05	ISO 8601
040506	ISO 8601
04:05 AM	Same as 04:05; AM does not affect value
04:05 PM	Same as 16:05; input hour must be <= 12

2.2.4.2.3 タイムスタンプ

タイムスタンプの有効な入力は、日付と時刻の連結で構成されます。タイムスタンプの日付部分は、 表2-7に 示すいずれかの例に従ってフォーマットすることができます 。タイムスタンプの時間部分は、 表2-8に 示す例のいずれかに従ってフォーマットすることができます 。

次は、 Oracleのデフォルト形式に従うタイムスタンプの例です。

08-JAN-99 04:05:06

以下は、 ISO 8601規格に 従ったタイムスタンプの例です 。

1999-01-08 04:05:06

2.2.4.3 日付/時刻出力

日付/時刻タイプのデフォルトの出力形式は、 Oracleデータベースと互換性の ある Redwood日付スタイル と呼ばれる（dd-MON-yy） か、ISO 8601フォーマットと呼ばれる（yyyy-mm-dd） データベース へ のアプリケーションインターフェイス上で実行さ れ ます。 SQL Interactive などのJDBCを使用するアプリケーションでは 、常に日付がISO 8601形式で表示されます。 PSQL などの他のアプリケーションでは、Redwood形式で日付が表示されます。

次の表は、RedwoodとISO 8601の2つのスタイルの出力形式の例を示しています。

表2-9日付/時刻出力スタイル

Description	Example
Redwood style	31-DEC-05 07:37:16
ISO 8601/SQL standard	1997-12-17 07:37:16

2.2.4.4 内部

Advanced Server では、すべての日付/時刻の計算にユリウス日付が使用されます。ユリウス暦の日付は、年の長さが365.2425日であるという前提に基づいて、4713年以降の任意の日付を正しく予測または計算します。

 

2.2.5 ブール型

Advanced Server は、標準 SQL タイプ BOOLEANを 提供し ます 。 BOOLEAN は、 TRUE または FALSEの 2つの状態のうちの1つを持つことができ ます 。第3の状態 UNKNOWN は、 SQL NULL 値。

表2-10ブール型

Name	Storage Size	Description
BOOLEAN	1 byte	Logical Boolean (true/false)

真の状態を表す有効なリテラル値は TRUE です。偽の状態を表す有効なリテラルは FALSE です。

 

2.2.6 XMLタイプ

XMLType データ型は、XMLデータを格納するために使用されます。 XMLデータを文字フィールドに格納することの利点は、整形式の入力値をチェックして、タイプセーフな操作を実行するためのサポート関数があることです。

XMLタイプでは、XML標準で定義されているように整形式の「ドキュメント」と、本番 XMLDeclで 定義されている「コンテンツ」フラグメントを 格納できますか？ XML標準の コンテンツ 大雑把に言えば、これは、コンテンツフラグメントが複数のトップレベル要素または文字ノードを持つことができることを意味します。

注意： Oracleでは、 XMLTYPE 列の コンテンツ・フラグメントの格納はサポートされていません 。

次の例は、 XMLTYPE 列 を持つ表に行を作成して挿入する方法を示してい ます。

CREATE TABLE books (

content XMLTYPE

);

 

INSERT INTO books VALUES (XMLPARSE (DOCUMENT '<?xml version="1.0"?><book><title>Manual</title><chapter>...</chapter></book>'));

 

SELECT * FROM books;

 

content

----------------------------------------------------------

<book><title>Manual</title><chapter>...</chapter></book>

(1 row)

 

2.3 SQLコマンド

この節では、 Advanced ServerでサポートされているOracleデータベースと互換性のある SQLコマンドの概要を示し ます 。このセクションのSQLコマンドは、 OracleデータベースとAdvanced Serverデータベースの両方で動作します。

次の点に注意してください。

•	Advanced Serverは、ここに記載されていない他のコマンドもサポートしています。これらのコマンドには、 Oracleと同等の機能がないか、 Oracle SQLコマンドと同様の機能を提供する可能性がありますが、構文は異なります。

•	このセクションの SQLコマンドは、各コマンドで使用できる完全な構文、オプション、および機能を必ずしも表すものではありません。ほとんどの場合、 Oracleデータベースと互換性のない構文、オプション、および機能は、コマンドの説明および構文から省略されています。

•	Advanced Serverのマニュアルセットのドキュメントには、Oracleデータベースと互換性がない可能性が機能を命じます。

 

2.3.1 ALTER INDEX

名

ALTER INDEX - 既存の索引を変更します。

シノプシス

Advanced Serverは 、Oracleデータベースと互換性のある ALTER INDEXコマンドの2つのバリエーションをサポートしています。インデックスの名前を変更するには、最初のバリエーションを使用します。

ALTER INDEX name RENAME TO new_name

ALTER INDEXコマンドの2番目のバリエーションを使用して 、インデックスを再構築します。

ALTER INDEX name REBUILD

説明

ALTER INDEXは、既存の索引の定義を変更します。 RENAME句は、索引の名前を変更します。 REBUILD句は、索引の古いコピーを索引の表に基づく更新版に置き換えて、索引を再構成します。

REBUILD句はPostgreSQLのREINDEXコマンドを起動します。 REBUILD句の使用の詳細については、PostgreSQLのコアドキュメントを参照してください。

https://www.postgresql.org/docs/11/static/sql-reindex.html

ALTER INDEXは、格納されたデータには影響しません。

パラメーター

名

既存の索引の名前（おそらくスキーマ修飾名）。

新しい名前

インデックスの新しい名前。

 

 

例

インデックスの名前をname_idx から empname_idxに変更するには ：

ALTER INDEX name_idx RENAME TO empname_idx;

empname_idx という名前のインデックスを再構築するには ：

ALTER INDEX empname_idx REBUILD;

関連項目

CREATE INDEX 、 DROP INDEX

 

2.3.2変更手順

名

変更手順  

シノプシス

ALTER PROCEDURE procedure _ name options [RESTRICT]

説明

ALTERを 使用する プロシージャーが セキュリティーである ことを指定する PROCEDURE ステートメント 招待者 または セキュリティ DEFINER 。

パラメーター

プロシージャ名

procedure_nameは、ストアド・プロシージャの名前（スキーマ修飾名）を指定します。

オプション 多分：

[外部]セキュリティディフェンダー

SECURITY DEFINERを指定して 、プロシージャーを作成したユーザーの特権でプロシージャーを実行するようにサーバーに指示します。 EXTERNALキーワードは互換性のために受け入れられますが、無視されます。

[外部]セキュリティ・インボーカ

SECURITY INVOKERを指定して 、プロシージャーを呼び出すユーザーの特権でプロシージャーを実行するようにサーバーに指示します。 EXTERNALキーワードは互換性のために受け入れられますが、無視されます。

RESTRICT キーワードは、互換性のために受け入れたが、無視されます。

例

次のコマンドは、 update _ balanceプロシージャを、プロシージャを呼び出すユーザーの権限で実行するように指定します。

ALTER PROCEDURE update_balance SECURITY INVOKER;

 

2.3.3 ALTER PROFILE

名

ALTER PROFILE - 既存のプロファイルを変更する

シノプシス

ALTER PROFILE profile_name RENAME TO new_name ;

 

ALTER PROFILE profile_name
LIMIT { parameter value }[...];

説明

ユーザー定義プロファイルを変更するには、 ALTER PROFILEコマンドを使用します。 Advanced Serverは、次の2つの形式のコマンドをサポートしています。

•	ALTER PROFILE ... RENAME TOを使用して 、プロファイルの名前を変更します。

•	ALTER PROFILE ... LIMITを使用して、プロファイルに関連付けられた制限を変更します。

Advanced Serverによって実行されるルールを指定するには 、 LIMIT 句と1つ以上のスペース区切り パラメータ / 値の ペアを 含める か、 ALTER PROFILE ... RENAME TOを使用してプロファイルの名前を変更します。

パラメーター

プロファイル名

プロファイルの名前。

新しい名前

new_nameは、プロファイルの新しい名前を指定します。

パラメータ

パラメータ は、プロファイルによって制限される属性を指定します。

値

value はパラメータの制限を指定します。

Advanced Serverは、 各 パラメータ について以下 の 値を サポートしてい ます 。

FAILED_LOGIN_ATTEMPTSは、サーバーがPASSWORD_LOCK_TIMEで指定された時間、アカウントからユーザーをロックする前に、ユーザーが失敗したログイン試行の回数を指定します。サポートされる値は次のとおりです。

•	0 以上 の整数値 。

•	DEFAULT - DEFAULT プロファイルで 指定された FAILED_LOGIN_ATTEMPTS の値 。

•	無制限 - 接続しているユーザーは、失敗したログイン試行回数を無制限にすることがあります。

PASSWORD_LOCK_TIME は、サーバーが FAILED_LOGIN_ATTEMPTSの ためにロックされたアカウントのロックを解除するまでの時間を指定します 。サポートされる値は次のとおりです。

•	0以上の 数値 。 1日の小数部分を指定するには、小数値を指定します。たとえば、値4.5を使用して4日12時間を指定します。

•	DEFAULT - DEFAULTプロファイルで指定されたPASSWORD_LOCK_TIMEの値。

•	無制限 -アカウントはデータベーススーパーユーザーによって手動でロック解除されるまでロックされます。

PASSWORD_LIFE_TIMEは、ユーザーに新しいパスワードを入力する前に現在のパスワードを使用する日数を指定します。 PASSWORD _ LIFE _ TIME句を使用する場合は、 PASSWORD _ GRACE _ TIME句を含めて、ロールによる接続が拒否されるまでにパスワードが期限切れになってから経過する日数を指定します。 PASSWORD _ GRACE _ TIMEが指定されていない場合、パスワードはPASSWORD _ GRACE _ TIMEのデフォルト値で指定された日に期限切れになり、ユーザーは新しいパスワードが提供されるまでコマンドを実行できなくなります。サポートされる値は次のとおりです。

•	0 以上 の 数値 。 1日の小数部分を指定するには、小数値を指定します。たとえば、値4.5を使用して4日12時間を指定します。

•	DEFAULT - DEFAULT プロファイルで 指定された PASSWORD_LIFE_TIME の値 。

•	無制限 - パスワードの有効期限はありません。

PASSWORD_GRACE_TIME パスワードが期限切れになった後、ユーザがパスワードを変更するまでの猶予期間の長さを示します。猶予期間が切れると、ユーザーは接続を許可されますが、期限切れのパスワードを更新するまでコマンドを実行することはできません 。サポートされる値は次のとおりです。

•	0 以上 の 数値 。 1日の小数部分を指定するには、小数値を指定します。たとえば、値4.5を使用して4日12時間を指定します。

•	DEFAULT - DEFAULT プロファイルで 指定された PASSWORD_GRACE_TIME の値 。

•	無制限 - 猶予期間は無限です。

PASSWORD_REUSE_TIMEは、ユーザーがパスワードを再使用するまで待機する日数を指定します。 PASSWORD _ REUSE _ TIMEとPASSWORD _ REUSE _ MAXパラメーターは、一緒に使用するためのものです。これらのパラメータの1つに有限値を指定し、他のパラメータを無制限に指定すると 、古いパスワードを決して再利用することはできません。両方のパラメータがUNLIMITEDに設定されている場合は、パスワードの再利用に制限はありません。サポートされる値は次のとおりです。

•	0 以上 の 数値 。 1日の小数部分を指定するには、小数値を指定します。たとえば、値4.5を使用して4日12時間を指定します。

•	DEFAULT - DEFAULT プロファイルで 指定された PASSWORD_REUSE_TIME の値 。

•	無制限 - パスワードは制限なしで再利用できます。

PASSWORD_REUSE_MAXは、パスワードを再利用できるようにするために必要なパスワードの変更回数を指定します。 PASSWORD _ REUSE _ TIMEとPASSWORD _ REUSE _ MAXパラメーターは、一緒に使用するためのものです。これらのパラメータの1つに有限値を指定し、他のパラメータを無制限に指定すると 、古いパスワードを決して再利用することはできません。両方のパラメータがUNLIMITEDに設定されている場合は、パスワードの再利用に制限はありません。サポートされる値は次のとおりです。

•	0 以上 の INTEGER 値 。

•	DEFAULT - DEFAULT プロファイルで 指定された PASSWORD_REUSE_MAX の値 。

•	無制限 - パスワードは制限なしで再利用できます。

PASSWORD_VERIFY_FUNCTIONはパスワードの複雑さを指定します。サポートされる値は次のとおりです。

•	PL / SQLファンクションの名前。

•	DEFAULT - DEFAULT プロファイルで 指定された PASSWORD_VERIFY_FUNCTION の値 。

•

ヌル

例

次の例では、 acctg_profile という名前のプロファイルを変更します 。

ALTER PROFILE acctg_profile
LIMIT FAILED_LOGIN_ATTEMPTS 3 PASSWORD_LOCK_TIME 1;

 

ログインロールがサーバへの接続を試みると、 acctg_profileは失敗した接続試行回数をカウントします。このプロファイルでは、ユーザーが3回の試行で正しいパスワードで認証されなかった場合、そのアカウントは1日ロックされるように指定されています。

次の例では、名前の変更 payables_profileにacctg_profileを ：

ALTER PROFILE acctg_profile RENAME TO payables_profile;

 

 

 

2.3.4 ALTER QUEUE

Advanced Serverには、Oracleによって提供されていない追加の構文が ALTER QUEUE SQL コマンド。この構文は、 DBMS _ AQADMパッケージに関連して使用できます。

名

ALTER QUEUE - スーパーユーザーまたは aq _ administrator _ ロール 特権を 持つユーザーが キューの属性を変更できるようにします。

シノプシス

このコマンドは、4つの形式で使用できます。このコマンドの最初の形式は、キューの名前を変更します。

ALTER QUEUE queue_name RENAME TO new _ name

パラメーター

キュー名

名前（オプションとして スキーマ修飾された）

リネーム に

RENAMEを 含める TO 句と、キューの名前を変更するキューの新しい名前。

新しい名前

キューの新しい名前。

2番目の形式の ALTER QUEUEコマンドは、キューの属性を変更します。

ALTER QUEUE キュー _ 名 SET [（{ オプション _ 名 オプション _ 値 } [、 SET オプション _ 名前

パラメーター

キュー名

名前（オプションとして スキーマ修飾された）

SET句とオプション _ name / option _ valueのペアを含めて 、キューの属性を変更します。

オプション _ 名前option_value

新しいキューに関連付けるオプションの名前および対応するオプションの値。重複するオプション名を指定すると、サーバーはエラーを返します。

•	場合は オプション _ 名です 再試行では、デキューを試行できる回数を表す整数を提供します。

•	オプション _ nameがretrydelayの 場合 、秒単位の遅延を表す倍精度値を指定します。

•	場合は オプション _ 名が 保持され、秒単位で保持時間を表し、倍精度値を提供します。

ALTER QUEUEコマンドの3番目の形式を使用して、特定のキューでエンキューおよび/またはデキューを有効または無効にします。

ALTER QUEUE キュー _ 名 ACCESS {START | STOP} [FOR {エンキュー|デキュー}] [NOWAIT]

パラメーター

キュー名

名前（オプションとして スキーマ修飾された）

アクセス

特定のキューでエンキューおよび/またはデキューを有効または無効にするには、 ACCESSキーワードを含めます。

スタート|やめる

STARTおよびSTOPキーワードを使用して 、キューの希望の状態を示します。

FORエンキュー|デキュー

FOR句を使用して、指定されたキューのエンキューまたはデキューの状態を指定するかどうかを指定します。

NOWAIT

キューの状態を変更する前に、未処理のトランザクションの完了をサーバーが待たないように指定するに は、 NOWAIT キーワードを 組み込み ます。 STOP の アクセス値 を 指定するときに NOWAIT キーワード にのみ使用することができます 。 NOWAIT が ACCESS 値 STARTで 指定されている 場合、サーバーはエラーを戻します 。

4番目のフォームを使用して 、特定のキューのコールバック詳細を ADDまたはDROPします。

ALTER QUEUE キュー _ 名 {ADD | DROP} CALL TO location _ name [WITH コールバック _ オプション ]

パラメーター

キュー名

名前（オプションとして スキーマ修飾された）

追加|ドロップ

キューのコールバックの詳細を追加または削除するには、 ADDキーワードまたはDROPキーワードを含めます。

場所の名前

location _ nameは、コールバックプロシージャの名前を指定します。

コールバック _ オプション

コールバック _ オプション コンテキストとすることができます。この句を含めるときはRAW値を指定してください。

例

次の例では、キューの名前 を work_queue_east から work_order に 変更し ます。

ALTER QUEUE work_queue_east RENAME TO work_order;

次の例では、再試行回数を100回、再試行間の遅延を2秒、キューからデキューされたメッセージを10秒間に保持する時間を設定して、 work_order という名前のキューを変更します 。

ALTER QUEUE work_order SET (retries 100, retrydelay 2, retention 10);

次のコマンドは、という名前のキューにエンキューとデキューを有効 work_order：

ALTER QUEUE work_order ACCESS START;

ALTER QUEUE work_order ACCESS START FOR enqueue;

ALTER QUEUE work_order ACCESS START FOR dequeue;

次のコマンドは、というキューにエンキューとデキューを無効にする 作業 _ 順 ：

ALTER QUEUE work_order ACCESS STOP NOWAIT;

ALTER QUEUE work_order ACCESS STOP FOR enqueue;

ALTER QUEUE work_order ACCESS STOP FOR dequeue;

関連項目

CREATE QUEUE 、 DROP QUEUE

 

2.3.5 ALTER QUEUE TABLE

Advanced Serverには、 ALTER QUEUE SQL コマンドで 追加の構文（Oracleでは提供されていません）が含まれています 。この構文は 、 DBMS_AQADMパッケージに関連して使用できます。

名

ALTER QUEUE TABLE - 既存のキュー表を変更します。

シノプシス

ALTER QUEUE TABLEを使用して 、既存のキュー表の名前を変更します。

ALTER QUEUE TABLE name RENAME TO new _ name

説明

ALTER TABLE QUEUEは、 スーパーユーザーまたは 水溶液 _ _ 管理者の 役割の 権限 を持つユーザーは 、既存のキュー表の名前を変更する こと が できます 。

パラメーター

名

名前（オプションとして スキーマ修飾された）既存のキュー表を削除します。

新しい名前

キュー表の新しい名前。

例

キュー表の名前を wo _ table _east から work_order_tableに 変更するには、 次の ようにし ます 。

ALTER QUEUE TABLE wo_queue_east RENAME TO work_order_table;

関連項目

CREATE QUEUE TABLE 、 DROP QUEUE TABLE

 

 

 

2.3.6 ALTER ROLE ...によって識別される

名

ALTER ROLE - データベースロールに関連付けられたパスワードを変更する

シノプシス

ALTER ROLE role_name IDENTIFIED BY password
[REPLACE prev_password ]

説明

CREATEROLE権限のないロールは、このコマンドを使用して自分のパスワードを変更できます。特権のないロールには、 PASSWORD _ VERIFY _ FUNCTIONがそのプロファイルでNULL でなければ 、 REPLACE句と以前のパスワードを含める必要があります 。 REPLACE句を非スーパーユーザーが使用すると、サーバーは既存のパスワードと比較し、パスワードが一致しない場合はエラーを発生させます。

データベースのスーパーユーザーは、このコマンドを使用して、任意のロールに関連付けられたパスワードを変更できます。スーパーユーザーが REPLACE句を含む場合 、その句は無視されます。前のパスワードの値が一致していてもエラーは発生しません。

パスワードが変更される ロールにSUPERUSER属性がある場合、スーパーユーザーはこのコマンドを発行する必要があります。 CREATEROLE属性を持つロールは、このコマンドを使用して、スーパーユーザーではないロールに関連付けられたパスワードを変更できます。

パラメーター

ロール名

パスワードを変更する役割の名前。

パスワード

ロールの新しいパスワード。

prev_password

ロールの以前のパスワード。

例

役割のパスワードを変更するには：

ALTER ROLE john IDENTIFIED BY xyRP35z REPLACE 23PJ74a;

 

2.3.7 ALTER ROLE - データベース・リンクおよびDBMS_RLS権限の管理

Advanced Serverには、 ALTER ROLEコマンド用の追加構文（Oracleでは提供されていません）が含まれています 。この構文は、Oracleデータベースと互換性のあるデータベース・リンクの作成および削除、および細かいアクセス制御（ DBMS_RLSを使用）に関連する権限を割り当てる場合に役立ちます。

CREATE DATABASE LINK

保持しているユーザー CREATE DATABASE LINK 権限は、プライベート・データベース・リンクを作成することができます。次のALTER ROLEコマンドは、指定されたロールがプライベート・データベース・リンクを作成できるようにAdvanced Serverロールに権限を付与します。

ALTER ROLE role _ name
WITH [CREATEDBLINK | CREATE DATABASE LINK]をクリックします。

このコマンドは、次の機能と同等です。

ロール _ 名 へのデータベースリンクの作成を許可する

特権を取り消すには、次のコマンドを使用します。

ALTER ROLE role _ name
WITH [NOCREATEDBLINK | NO CREATE DATABASE LINK]

ご注意： CREATEDBLINKとNOCREATEDBLINKキーワードは廃止予定の構文と考えるべきです。 CREATE DATABASE LINKおよびNO CREATE DATABASE LINK構文オプションを使用することをお勧めします。

パブリックデータベースリンクを作成する

保持しているユーザー CREATE PUBLIC DATABASE LINK 権限は、パブリック・データベース・リンクを作成することができます。次のALTER ROLEコマンドは、指定されたロールがパブリック・データベース・リンクを作成できるようにするAdvanced Serverロールに権限を付与します。

ALTER ROLE role _ name
WITH [CREATEPUBLICDBLINK |パブリックデータベースリンクの作成]

このコマンドは、次の機能と同等です。

ロール _ 名 へのパブリックデータベースリンクの作成を許可する

特権を取り消すには、次のコマンドを使用します。

ALTER ROLE role _ name
WITH [NOCREATEPUBLICDBLINK | NO PUBLIC DATABASEの リンクを 作成しません ]

ご注意： CREATEPUBLICDBLINKとNOCREATEPUBLICDBLINKキーワードは廃止予定の構文と考えるべきです。私たちは、PUBLIC DATABASE LINKの構文オプションをCREATE PUBLIC DATABASEの リンクを 作成し、NO使用をお勧めします。

公衆データベースリンクを抹消する

保持しているユーザー DROP PUBLIC DATABASE LINK 権限は、パブリック・データベース・リンクをドロップすることがあります。次のALTER ROLEコマンドは、指定されたロールがパブリック・データベース・リンクを削除できるようにするAdvanced Serverロールに権限を付与します。

ALTER ROLE role _ name
WITH [DROPPUBLICDBLINK | DROP PUBLIC DATABASE LINK]

このコマンドは、次の機能と同等です。

ロール _ 名に PUBLIC DATABASE LINKを付与する

特権を取り消すには、次のコマンドを使用します。

ALTER ROLE role _ name
WITH [NODROPPUBLICDBLINK | NO DROP PUBLIC DATABASEの LINKません]

ご注意： DROPPUBLICDBLINKとNODROPPUBLICDBLINKキーワードは廃止予定の構文と考えるべきです。私たちは、DROP PUBLIC DATABASEの LINKとNO DROP PUBLIC DATABASE LINKの構文オプションを使用することをお勧めします。

退出のためのアクセスポリシー

保持しているユーザー EXEMPT ACCESS POLICY 権限は、ファイングレイン・アクセス・コントロール（DBMS_RLS）ポリシーを免除されています。これらの権限を持つユーザーは、 DBMS_RLSポリシーで制約された表の行をすべて表示または変更できます。次のALTER ROLEコマンドは、指定されたDBMS_RLSポリシーから指定されたロールを除外する Advanced Serverロールに権限を付与します。

ALTER ROLE role_name
WITH [POLICYEXEMPT |免除ポリシーを守る]

このコマンドは、次の機能と同等です。

ロール名へのアクセス許可の付与

特権を取り消すには、次のコマンドを使用します。

ALTER ROLE role_name
WITH [NOPOLICYEXEMPT |退出時のアクセスポリシーなし]

ご注意： POLICYEXEMPTとNOPOLICYEXEMPTキーワードは廃止予定の構文と考えるべきです。我々はEXEMPTアクセスポリシーとNO EXEMPTアクセスポリシーの構文オプションを使用することをお勧めします。

関連項目

CREATE ROLE 、 DROP ROLE 、 GRANT 、 REVOKE 、 SET ROLE

 

2.3.8 ALTER SEQUENCE

名

ALTER SEQUENCE - シーケンスジェネレータの定義を変更する

シノプシス

ALTER SEQUENCE name [ INCREMENT BY increment ]

[ MINVALUE minvalue ] [ MAXVALUE maxvalue ]

[ CACHE cache | NOCACHE ] [ CYCLE ]

説明

ALTER SEQUENCEは、既存のシーケンスジェネレータのパラメータを変更します。 ALTER SEQUENCEコマンドで特に設定されていないパラメータは、その前の設定を保持します。

パラメーター

名

変更されるシーケンスの名前（スキーマ修飾名も可）

インクリメント

句の 増分 BY INCREMENTはオプションです。正の値は昇順のシーケンスを、負の値は降順のシーケンスを作成します。指定されていない場合は、古い増分値が維持されます。

最小値

オプションの節 MINVALUE minvalue は、シーケンスが生成できる最小値を決定します。指定しない場合、現在の最小値は維持されます。キーワード NO MINVALUEを 使用して、この動作を それぞれ昇順および降順 のデフォルトの1および-2 63 -1に 戻すこと ができ ます が、この用語は Oracleデータベースと互換性 がありません 。

マックスバリュー

オプション節 MAXVALUE maxvalue は、シーケンスの最大値を決定します。指定しない場合、現在の最大値は維持されます。キーワード NO MAXVALUEを 使用して 、昇順および降順のそれぞれに対して この動作をデフォルトの2 63 -1および-1に 戻すこと ができ ます が、この用語は Oracleデータベースと互換性 がありません 。

キャッシュ

オプションの CACHE 節 キャッシュ は、より早くアクセスできるように、事前割り当てされ、メモリに格納されるシーケンス番号の数を指定します。最小値は1です（一度に生成できる値は1つのみ、つまり NOCACHE ）。未指定の場合、古いキャッシュ値が維持されます。

サイクル

MAXVALUE または MINVALUEが 昇順で到達したか、それぞれ降順された 際に CYCLE オプションは、シーケンスがラップアラウンドすることができます 。 限界に達した場合、生成された次の番号は、それぞれ、MINVALUE または MAXVALUE であろう 。指定しなかった場合、古いサイクルの動作は維持されます。キーワードNO CYCLEを使用してシーケンスを変更してリサイクルしないようにすることもできますが、この用語はOracleデータベースと互換性がありません。

ノート

同じシーケンスから数値を取得する同時トランザクションのブロッキングを回避するために、 ALTER SEQUENCEはロールバックされません。変更はすぐに有効になり、元に戻すことはできません。

ALTER SEQUENCEは、事前割り振り済み（キャッシュされた）順序値を持つバックエンド（現行のもの以外）のNEXTVAL結果に直ちに影響を与えません。変更されたシーケンスパラメータに気づく前に、すべてのキャッシュされた値を使い切ります。現在のバックエンドはすぐに影響を受けます。

例

シーケンス serial のインクリメントとキャッシュの値を変更します 。

ALTER SEQUENCE serial INCREMENT BY 2 CACHE 5;

関連項目

CREATE SEQUENCE 、 DROP SEQUENCE

 

2.3.9 ALTER SESSION

名

ALTER SESSION - 実行時パラメータを変更する

シノプシス

ALTER SESSION SET name = value

説明

ALTER SESSIONコマンドは実行時設定パラメータを変更します。 ALTER SESSIONは、現在のセッションで使用されている値にのみ影響します。これらのパラメータの一部は、 Oracle構文との互換性のためにのみ提供されており、 Advanced Serverのランタイム動作には何の影響も与えません。他のユーザーは、対応するAdvanced Serverデータベース・サーバーのランタイム構成パラメーターを変更します。

パラメーター

名

設定可能なランタイムパラメータの名前。使用可能なパラメータは以下のとおりです。

値

パラメータの新しい値。

構成パラメータ

次の構成パラメータは、 ALTER SESSIONコマンドを使用して変更できます 。

NLS_DATE_FORMAT（文字列）

あいまいな日付入力値を解釈するための規則と同様に、日付と時刻の値の表示形式を設定します。 Advanced Server datestyleランタイム構成パラメーターの設定と同じ効果があります。

NLS_LANGUAGE（文字列）

メッセージが表示される言語を設定します。 Advanced Serverの lc_messagesランタイム構成パラメーターの設定と同じ効果があります。

NLS_LENGTH_SEMANTICS（文字列）

有効な値は BYTEおよびCHARです。デフォルトはBYTEです。このパラメータは、構文の互換性のためにのみ提供され、Advanced Serverでは無効です。

OPTIMIZER_MODE（文字列）

クエリのデフォルト最適化モードを設定します。有効な値は、 ALL_ROWS 、 CHOOSE 、 FIRST_ROWS 、 FIRST_ROWS_10 、 FIRST_ROWS_100 、およびFIRST_ROWS_1000です。デフォルトはCHOOSEです。このパラメータは、 Advanced Serverで実装されています 。

QUERY_REWRITE_ENABLED（文字列）

有効な値は、 TRUE 、 FALSE 、およびFORCEです。デフォルトはFALSEです。このパラメータは、構文の互換性のためにのみ提供され、 Advanced Serverでは無効です。

QUERY_REWRITE_INTEGRITY（文字列）

有効な値は ENFORCED 、 TRUSTED 、およびSTALE_TOLERATEDです。デフォルトはENFORCEDです。このパラメータは、構文の互換性のためにのみ提供され、 Advanced Serverでは無効です。

例

UTF-8エンコーディングで言語をUS Englishに設定します。この例では、値 en_US.UTF-8はAdvanced Serverに指定する必要がある形式であることに注意してください 。このフォームは、 Oracleデータベースと互換性がありません。

ALTER SESSION SET NLS_LANGUAGE = 'en_US.UTF-8';

日付表示形式を設定します。

ALTER SESSION SET NLS_DATE_FORMAT = 'dd/mm/yyyy';

 

2.3.10 ALTER TABLE

名

ALTER TABLE - テーブルの定義を変更する

シノプシス

ALTER TABLE name

action [, ...]

ALTER TABLE name

RENAME COLUMN column TO new_column

ALTER TABLE name

RENAME TO new_name

どこ アクションは、次のいずれかです。

ADD column type [ column_constraint [ ... ] ]

DROP COLUMN column

ADD table_constraint

DROP CONSTRAINT constraint_name [ CASCADE ]

説明

ALTER TABLEは、既存のテーブルの定義を変更します。いくつかのサブフォームがあります：

ADD 列 タイプ

このフォームは、 CREATE TABLE と同じ構文を使用してテーブルに新しい列を追加します 。

DROP COLUMN

このフォームは、テーブルから列を削除します。列を含む索引および表の制約も自動的に削除されます。

ADD table_constraint

このフォームは、 CREATE TABLE と同じ構文を使用してテーブルに新しい制約を追加します 。

DROP CONSTRAINT

このフォームは、テーブルの制約を削除します。現在、テーブルの制約には一意の名前を付ける必要はないため、指定された名前に一致する制約が複数存在する可能性があります。すべての一致する制約は削除されます。

リネーム

RENAME形態は、テーブルの名前（またはインデックス、シーケンス、またはビュー）または表の個々の列の名前を変更します。保存されたデータには何の影響もありません。

ALTER TABLE を使用するには、表を所有している必要があります 。

パラメーター

名

変更する既存のテーブルの名前（おそらくスキーマ修飾名）。

カラム

新しい列または既存の列の名前。

new_column

既存の列の新しい名前。

新しい名前

テーブルの新しい名前。

タイプ

新しい列のデータ型。

table_constraint

テーブルの新しいテーブル制約。

constraint_name

削除する既存の制約の名前。

カスケード

ドロップされた制約に依存するオブジェクトを自動的にドロップします。

ノート

ADD COLUMN を呼び出すと、表の既存の行はすべて、列のデフォルト値（ DEFAULT句が指定されていない場合はNULL）で初期化されます。 NULL以外の既定値を持つ列を追加するには、テーブル全体を書き換える必要があります。これは、大きなテーブルにはかなりの時間がかかることがあります。一時的に2倍のディスク容量が必要になります。 CHECKまたはNOT NULL制約を追加するには、既存の行が制約を満たしていることを確認するために表をスキャンする必要があります。

DROP COLUMNのフォームは、物理的に列を削除、単にSQL操作にそれが見えなくなりません。表の後続の挿入操作および更新操作では、その列にヌル値が保管されます。したがって、列を削除することは迅速ですが、削除された列が占有する領域が再利用されないため、表のディスク上のサイズはすぐには減少しません。スペースは、既存の行が更新されると時間の経過とともに再利用されます。

システムカタログ表の一部を変更することはできません。 CREATE TABLEを 参照して ください。 有効なパラメータの詳細については、

例

VARCHAR2 型の列を表に追加するには、次のようにします。

ALTER TABLE emp ADD address VARCHAR2(30);

テーブルから列を削除するには：

ALTER TABLE emp DROP COLUMN address;

既存の列の名前を変更するには：

ALTER TABLE emp RENAME COLUMN address TO city;

既存のテーブルの名前を変更するには：

ALTER TABLE emp RENAME TO employee;

テーブルにチェック制約を追加するには：

ALTER TABLE emp ADD CONSTRAINT sal_chk CHECK (sal > 500);

テーブルからチェック制約を削除するには：

ALTER TABLE emp DROP CONSTRAINT sal_chk;

関連項目

CREATE TABLE 、 DROP TABLE

 

2.3.11 ALTER TABLESPACE

名

ALTER TABLESPACE - 表領域の定義を変更する

シノプシス

ALTER TABLESPACE name RENAME TO newname

説明

ALTER TABLESPACEは、表領域の定義を変更します。

パラメーター

名

既存の表領域の名前。

新しい名前

表スペースの新しい名前。この名前はシステム表スペース用に予約されているため、 新しい名前は pg_で始めることはできません 。

例

表領域 empspaceの 名前をemployee_spaceに変更します。

ALTER TABLESPACE empspace RENAME TO employee_space;

関連項目

DROP TABLESPACE

 

2.3.12 ALTER USER ... IDENTIFIED BY

名

ALTER USER - データベースユーザーアカウントを変更する

シノプシス

ALTER USER role_name IDENTIFIED BY password REPLACE prev_password

説明

CREATEROLE権限のないロールは、このコマンドを使用して自分のパスワードを変更できます。特権のないロールには、 PASSWORD _ VERIFY _ FUNCTIONがそのプロファイルでNULL でなければ 、 REPLACE句と以前のパスワードを含める必要があります 。 REPLACE句を非スーパーユーザーが使用すると、サーバーは既存のパスワードと比較し、パスワードが一致しない場合はエラーを発生させます。

データベースのスーパーユーザーは、このコマンドを使用して、任意のロールに関連付けられたパスワードを変更できます。スーパーユーザーが REPLACE句を含む場合 、その句は無視されます。前のパスワードの値が一致していてもエラーは発生しません。

パスワードが変更される ロールにSUPERUSER属性がある場合、スーパーユーザーはこのコマンドを発行する必要があります。 CREATEROLE属性を持つロールは、このコマンドを使用して、スーパーユーザーではないロールに関連付けられたパスワードを変更できます。

パラメーター

ロール名

パスワードを変更する役割の名前。

パスワード

ロールの新しいパスワード。

prev_password

ロールの以前のパスワード。

例

ユーザーパスワードを変更する：

ALTER USER john IDENTIFIED BY xyRP35z REPLACE 23PJ74a;

関連項目

CREATE USER 、 DROP USER

 

2.3.13 ALTER USER | ROLE ...プロファイル管理の規約

名

ALTER USER | ROLE

シノプシス

ALTER USER|ROLE name [[WITH] option[…]

どこ オプションは、 次の互換性の句を指定できます。

PROFILE profile_name

| ACCOUNT {LOCK|UNLOCK}

| PASSWORD EXPIRE [AT ' timestamp ']

または オプション は、次の互換性のない節に する ことができます。

| PASSWORD SET AT ' timestamp '

| LOCK TIME ' timestamp '
| STORE PRIOR PASSWORD { 'password' 'timestamp } [, ...]

Advanced ServerでサポートされているALTER USERコマンドまたはALTER ROLEコマンドの管理句については 、次のURLにあるPostgreSQLのコアドキュメントを参照してください。

https://www.postgresql.org/docs/11/static/sql-commands.html

データベースのスーパーユーザーだけが ALTER を使用できます ユーザー | プロファイル管理を実施する ROLE 句 この条項は、次のような行動を強制します。

事前定義されたプロファイルを役割に関連付ける、または事前定義されたプロファイルがユーザーに関連付けられていることを変更するには、 PROFILE句とprofile_nameを含めます。

ACCOUNT句とLOCKまたはUNLOCKキーワードを含めて、ユーザー・アカウントをロック状態またはロック解除状態にする必要があることを指定します。

インクルードこのロールに割り当てられたプロファイルのTIMEパラメータ _ _ LOCK指定した時刻に役割をロックするLOCK TIME「 タイムスタンプ 」句と日付/時刻値を、およびPASSWORDで示される時点で役割のロックを解除します。 LOCK TIMEを ACCOUNT LOCK句とともに使用すると、ロールはACCOUNT UNLOCK句を使用してデータベースのスーパーユーザーのみがロックを解除できます。

パスワードを 含める ATの EXPIRE 句 ' timestamp ' キーワードを使用して、ロールに関連付けられたパスワードの有効期限が切れる日時を指定します。 AT を省略すると ' timestamp ' キーワードを入力すると、パスワードはすぐに期限切れになります。

パスワードを 含める セット AT ' timestamp ' キーワードを使用して、パスワード修正日を指定された時間に設定します。

ストアを 含める 先行 パスワード { 'パスワード' 'タイムスタンプ } [、...] 新しいパスワードとパスワードが設定された時刻を追加します。

各ログインロールは1つのプロファイルのみを持つことができます。現在ログイン・ロールに関連付けられているプロファイルを検出するには、 DBA_USERSビューのプロファイル列を問い合せます。

パラメーター

名

指定されたプロファイルが関連付けられるロールの名前。

パスワード

ロールに関連付けられたパスワード。

プロファイル名

ロールに関連付けられるプロファイルの名前。

タイムスタンプ

条項が適用される日時。 タイムスタンプの 値を指定する場合は 、値を一重引用符で囲みます。

ノート

ALTER USERコマンドまたはALTER ROLEコマンドのPostgres互換の節については、次のPostgreSQLコアのマニュアルを参照してください。

https://www.postgresql.org/docs/11/static/sql-alterrole.html

例

次のコマンドは、 ALTER USER ... PROFILEコマンドを使用して、 acctgという名前のプロファイルをjohnという名前のユーザーに関連付けます。

ALTER USER john PROFILE acctg_profile;

次のコマンドは、 ALTER ROLE ... PROFILEコマンドを使用して、 acctgという名前のプロファイルをjohnという名前のユーザーに関連付けます。

ALTER ROLE john PROFILE acctg_profile;

 

 

2.3.14 CALL

名

コール

シノプシス

CALL procedure_name '('[ argument _ list ]')'

説明

プロシージャーを呼び出すには、 CALLステートメントを使用します。 CALLステートメントを使用するには、 CALLステートメントが呼び出すプロシージャーに対してEXECUTE特権が必要です。

パラメーター

プロシージャ名

procedure_nameは、（オプションでスキーマ修飾された）プロシージャ名です。

argument_list

argument_listは、プロシージャーで必要な引数のカンマ区切りのリストを指定します。 argument_listの各メンバーは、プロシージャーが予期する仮引数に対応することに注意してください。各仮引数は、 INパラメーター、 OUTパラメーター、またはINOUTパラメーターです。

例

CALL文は、プロシージャによって必要な引数に応じて、いくつかのいずれかの形式を取ることがあります。

CALL update_balance();
CALL update_balance(1,2,3);

 

2.3.15 COMMENT

名

COMMENT - オブジェクトのコメントを定義または変更する

シノプシス

COMMENT ON

{

TABLE table_name |

COLUMN table_name . column_name

} IS ' text '

説明

COMMENTは、データベースオブジェクトに関するコメントを格納します。コメントを変更するには、同じオブジェクトに対して新しいCOMMENTコマンドを発行します。各オブジェクトには1つのコメント文字列しか格納されません。コメントを削除するには、 テキスト用に空の文字列（空白がない2つの連続した一重引用符）を指定します 。コメントは、オブジェクトがドロップされると自動的に削除されます。

パラメーター

テーブル名

コメントを付けるテーブルの名前。テーブル名はスキーマで修飾されていてもかまいません。

table_name 。 列名

コメントを付ける table_name 内の列の名前 。テーブル名はスキーマで修飾されていてもかまいません。

テキスト

新しいコメント。

ノート

現在のところ、コメントのセキュリティメカニズムはありません。データベースに接続しているすべてのユーザーは、データベース内のオブジェクトのすべてのコメントを見ることができます（ただし、スーパーユーザーのみが所有していないオブジェクトのコメントを変更できます）。 セキュリティ上重要な情報をコメントに入れないでください。

例

表 empに コメントを添付します 。

COMMENT ON TABLE emp IS 'Current employee information';

emp表のempno列にコメントを添付します。

COMMENT ON COLUMN emp.empno IS 'Employee identification number';

これらのコメントを削除します。

COMMENT ON TABLE emp IS '';

COMMENT ON COLUMN emp.empno IS '';

 

2.3.16 COMMIT

名

COMMIT - 現在のトランザクションをコミットする

シノプシス

COMMIT [ WORK ]

説明

COMMITは現在のトランザクションをコミットします。トランザクションによって行われたすべての変更は、他の人にも見えるようになり、クラッシュが発生した場合でも耐久性が保証されます。

パラメーター

作業

オプションのキーワード - 効果はありません。

ノート

トランザクションを中止するには、ROLLBACKを使用します。トランザクション内でないときにCOMMITを 発行することは問題ありません。

注意： plpgsqlプロシージャでCOMMITを実行すると、ランタイム・スタックにOracleスタイルのSPLプロシージャがある場合はエラーが発生します。

例

現在のトランザクションをコミットし、すべての変更を永久にするには：

COMMIT;

関連項目

ロールバック 、 ロール バック 、 SAVEPOINT

 

2.3.17 CREATE DATABASE

名

CREATE DATABASE - 新しいデータベースを作成する

シノプシス

CREATE DATABASE name

説明

CREATE DATABASEは新しいデータベースを作成します。

データベースを作成するには、スーパーユーザーであるか、特別な CREATEDB特権を持っていなければなりません 。通常、作成者は新しいデータベースの所有者になります。 CREATEDB特権を持つ非スーパーユーザーは、所有しているデータベースのみを作成できます。

新しいデータベースは、標準システムデータベース template1を 複製することによって作成されます 。

パラメーター

名

作成するデータベースの名前。

ノート

CREATE DATABASEはトランザクションブロック内では実行できません。

「 データベースディレクトリを初期化 できませんでした」という行に沿ったエラーは、データディレクトリ、フルディスク、またはその他のファイルシステムの問題に対する不十分なアクセス許可に関連している可能性があります。

例

新しいデータベースを作成するには：

CREATE DATABASE employees;

 

2.3.18 [PUBLIC]データベースリンクの作成

名

CREATE [PUBLIC] DATABASE LINK - 新しいデータベースリンクを作成します。

シノプシス

CREATE [ PUBLIC ] DATABASE LINK name

CONNECT TO { CURRENT_USER |

username IDENTIFIED BY ' password '}

USING { postgres_fdw ' fdw_connection_string ' |

[ oci ] ' oracle _ connection _ string ' }

説明

CREATE DATABASE LINKは新しいデータベースリンクを作成します。データベース・リンクは、 DELETE 、 INSERT 、 SELECTまたはUPDATEコマンド内のリモート・データベース内の表またはビューへの参照を可能にするオブジェクトです。データベースリンクは、 SQLコマンドで参照されるテーブルまたはビュー名に@ dblinkを追加することによって参照されます。ここで、 dblinkはデータベースリンクの名前です。

データベースリンクは公開または非公開にすることができます。 パブリック・データベース・リンクは、任意のユーザーが使用することができるものです。 プライベート・データベース・リンクは、データベース・リンクの所有者のみが使用できます。 PUBLICオプションを指定すると、パブリックデータベースリンクが作成されます。省略すると、プライベートデータベースリンクが作成されます。

場合は 、CREATE DATABASE LINKコマンドは、データベース・リンク名を与えられ、与えられた接続属性はpg_catalog.edb_dblink、名前のAdvanced Serverのシステムテーブルに格納されています。特定のデータベースリンクを使用する場合、このデータベースリンクを定義するedb_dblinkエントリを含むデータベースをローカルデータベースと呼びます 。接続属性がedb_dblinkエントリ内で定義されているサーバーとデータベースは、 リモートデータベースと呼ばれます

ローカル・データベースに接続しながら、データベース・リンクへの参照を含むSQLコマンドを発行する必要があります。 SQLコマンドが実行されると、適切な認証と接続がリモートデータベースに対して行われ、 @ dblink参照が追加されたテーブルまたはビューにアクセスします。

注：データベース・リンクを使用して、スタンバイ・データベース・サーバー内のリモート・データベースにアクセスすることはできません。スタンバイデータベースサーバーは、高可用性、負荷分散、およびレプリケーションに使用されます。

PostgreSQLデータベースサーバの高可用性、ロードバランシング、およびレプリケーションについては、次のURLにあるPostgreSQLのコアドキュメントを参照してください。

https://www.postgresql.org/docs/11/static/high-availability.html

注意： Advanced Server 10では、 CREATE DATABASE LINKコマンドは、Oracleバージョン10gリリース2（10.2）、Oracleバージョン11gリリース2（11.2）、およびOracleバージョン12cリリース1（12.1）で使用するためにテストされ、認証されています。

パラメーター

パブリック

任意のユーザーが使用できる公開データベースリンクを作成します。省略された場合、データベースリンクはプライベートであり、データベースリンクの所有者のみが使用できます。

名

データベースリンクの名前。

ユーザー名

リモート・データベースへの接続に使用されるユーザー名。

現在の使用者

リモートサーバーへの接続を確立するときに、リンクを使用しているロールに関連付けられているユーザーマッピングをAdvanced Serverが使用するように指定するには、 CURRENT_USERをインクルードします。

パスワード

username のパスワード 。

postgres_fdw

リモートのAdvanced Serverデータベースへの接続として外部データラッパー postgres_fdwを指定します。 postgres_fdwがデータベースにインストールされていない場合は、 CREATE EXTENSIONコマンドを使用してpostgres_fdwをインストールします。詳細については、PostgreSQL CoreのドキュメントのCREATE EXTENSIONコマンドを参照してください。

https://www.postgresql.org/docs/11/static/sql-createextension.html

fdw_connection_string

postgres_fdw外部データラッパーの接続情報を指定します。

オシ

リモート Oracleデータベースへの接続を指定します。これは、Advanced Serverのデフォルト動作です。

oracle_connection_string

oci接続の接続情報を指定します。

ノート

非パブリック・データベース・リンクを作成するには、 CREATE DATABASE LINK権限が必要です。パブリック・データベース・リンクを作成するには、 CREATE PUBLIC DATABASE LINK権限が必要です。

oci-dblinkのためのOracle Instant Clientの設定

oci-dblinkを使用するには、データベース・リンクを作成するAdvanced Serverデータベースを実行しているホストに、Oracleインスタント・クライアントをダウンロードしてインストールする必要があります。

インスタントクライアントは、次のサイトからダウンロードできます。

http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html

Linux用Oracle Instant Client

次の手順は、Advanced Serverを実行するLinuxホストに適用されます。

Advanced Serverを実行しているLinuxホストにlibaioライブラリ（Linux固有の非同期I / O機能）がインストールされていることを確認してください 。

libaioのライブラリは、以下のコマンドでインストールすることができます。

yum install libaio

ダウンロードしたOracleインスタント・クライアントに 、バージョン番号サフィックスがないlibclntsh.so という名前のファイルが含まれていない場合は、ライブラリ・ファイルのダウンロード・バージョンを指すlibclntsh.soというシンボリック・リンクを作成する必要があります。インスタントクライアントディレクトリに移動し、次のコマンドを実行します。

ln -s libclntsh.so。 バージョン libclntsh.so

どこ バージョンは libclntsh.soライブラリのバージョン番号です。例えば：

ln -s libclntsh.so.12.1 libclntsh.so

リモートOracleデータベースへのデータベース・リンクを参照する SQLコマンドを実行する場合 、Advanced ServerはOracleインスタント・クライアント・ライブラリがAdvanced Serverホスト上のどこにあるかを知る必要があります。

LD _ _ LIBRARY PATH環境変数には、libclntsh.soファイルを含むOracleクライアントのインストールディレクトリへのパスを含める必要があります。たとえば、 libclntsh.soを含むインストールディレクトリが/ tmp / instantclientであると仮定します。

エクスポートLD_LIBRARY_PATH = / tmp / instantclient：$ LD_LIBRARY_PATH

注意：このLD _ _ LIBRARY にpg_ctlユーティリティは、Advanced Serverを起動または再起動するために実行されたときにPATH環境変数の設定が有効でなければなりません。

現在のセッションをpg_ctlを直接起動してAdvanced Serverを起動または再起動するユーザーアカウント（たとえば enterprisedb ） として実行している場合は、 pg_ctlを呼び出す前に必ずLD_LIBRARY_PATHを設定してください 。

LD_LIBRARY_PATHは、 enterprisedbユーザーアカウントのホームディレクトリの下の.bash_profileファイル内で設定できます（つまり、 file〜enterprisedb / .bash_profile内にLD_LIBRARY_PATHを設定します）。このようにして、 enterprisedbとしてログインすると、 LD_LIBRARY_PATHが設定されます。

ただし、 systemctlまたはserviceコマンドでLinuxサービス・スクリプトを使用して Advanced Serverを起動または再起動している場合は、サービススクリプト内でLD_LIBRARY_PATHを設定して、スクリプトがpg_ctlユーティリティーを呼び出すときに有効にする必要があります。

LD_LIBRARY_PATH設定を含むように変更する必要がある特定のスクリプトファイルは 、Advanced Serverのバージョン、インストールされているLinuxシステム、およびグラフィカルインストーラまたはRPMパッケージと共にインストールされたかどうかによって異なります。

スタートアップ環境に影響を与えるサービススクリプトを調べるには、適切なバージョンの EDB Postgres Advanced Serverインストールガイドを参照してください 。インストールガイドは、次の場所にあります。

https://www.enterprisedb.com/resources/product-documentation

Windows用Oracle Instant Client

次の手順は、Advanced Serverを実行するWindowsホストに適用されます。

リモートOracleデータベースへのデータベース・リンクを参照する SQLコマンドを実行する場合 、Advanced ServerはOracleインスタント・クライアント・ライブラリがAdvanced Serverホスト上のどこにあるかを知る必要があります。

oci.dllファイルを含むOracleクライアントインストールディレクトリを含めるように、Windows PATHシステム環境変数を設定します。

代わりに、 postgresqlに oracle _ home構成パラメータの値を設定できます。 confファイル。 oracle _ home構成パラメータで指定された値は、Windows PATH環境変数よりも優先されます。

設定するには、 PostgreSQLでのOracle _ ホーム設定パラメータを。 confファイルを編集し、次の行を追加してファイルを編集します。

oracle_home = ' lib_directory '

oci を含むWindowsディレクトリの名前に 置き換えてください 。 lib_directoryのためのdll 。例えば：

oracle_home = 'C：/ tmp / instantclient_10_2'

設定後 PATH環境変数またはOracle _ 家庭の構成パラメータを、変更を有効にするには、サーバーを再起動する必要があります。 Windowsサービスコンソールからサーバーを再起動します。

注： tnsnames.oraがフェイルオーバー・モードで構成され、クライアント：サーバーの障害が発生すると、セカンダリ・サーバー（通常はバックアップ・サーバー）とのクライアント接続が確立されます。その後、プライマリサーバーが再開すると、クライアントは新しいセッションが確立されるまでセカンダリサーバーへの接続を保持します。新しいクライアント接続はプライマリサーバと自動的に確立されます。プライマリ・サーバとセカンダリ・サーバが同期していない場合、セカンダリ・サーバへの接続を確立したクライアントと、後でプライマリ・サーバに接続したクライアントが異なるデータベース・ビューを参照する可能性があります。

例

oci-dblinkデータベースリンクの作成

次の例は、 CREATE DATABASE LINKコマンドを使用して、Advanced Serverのインスタンスをoci-dblink接続を介してOracleサーバーに接続するデータベース・リンク（ chicago ）を作成する方法を示しています。接続情報はAdvanced Serverに対して、パスワードがmypasswordのユーザーadminとしてOracleにログインするように指示します。 ociオプションを含めると、これはoci-dblink接続であることがAdvanced Serverに伝えられます。接続文字列'//127.0.0.1/acctg'は、サーバーのアドレスとデータベースの名前を指定します。

CREATE DATABASE LINK chicago

CONNECT TO admin IDENTIFIED BY 'mypassword'

USING oci '//127.0.0.1/acctg';

注：接続文字列に（IPアドレスの代わりに）ホスト名を指定することができます。

postgres_fdwデータベースリンクの作成

次の例は、 CREATE DATABASE LINKコマンドを使用して、 postgres_fdw外部データラッパー接続を介してAdvanced Serverのインスタンスを別のAdvanced Serverインスタンスに接続するデータベースリンク（ bedford ）を作成する方法を示しています。接続情報はAdvanced Serverにパスワードがmypasswordのユーザーadminとしてログインするように指示します。 postgres_fdwオプションを含めると、これはpostgres_fdw接続であることがAdvanced Serverに伝えられます。接続文字列'host = 127.0.0.1 port = 5444 dbname = marketing'は、データベースのサーバーアドレスと名前を指定します。

CREATE DATABASE LINK bedford

CONNECT TO admin IDENTIFIED BY 'mypassword'

USING postgres_fdw 'host=127.0.0.1 port=5444 dbname=marketing';

注：接続文字列に（IPアドレスの代わりに）ホスト名を指定することができます。

データベースリンクの使用

次の例は、Advanced Serverでデータベース・リンクを使用してOracleデータベースに接続する方法を示しています。この例では、 Advanced Serverサンプル・アプリケーションのemp表のコピーが Oracleデータベースに作成され、サンプル・アプリケーションを含む2番目のAdvanced Serverデータベース・クラスタがポート5443で接続を受け入れていると想定しています。

ポート1521の127.0.0.1にあるxeというOracleデータベースにoralink という名前のパブリック・データベース・リンクを作成し ます 。ユーザー名、 edbおよびパスワード、 パスワードを使用してOracleデータベースに接続します 。

CREATE PUBLIC DATABASE LINK oralink CONNECT TO edb IDENTIFIED BY 'password' USING '//127.0.0.1:1521/xe';

データベースリンク、 oralinkを使用して、 Oracleデータベースのempテーブルに対して SELECTコマンドを発行します。

SELECT * FROM emp@oralink;

 

empno | ename | job | mgr | hiredate | sal | comm | deptno

-------+--------+-----------+------+--------------------+------+------+--------

7369 | SMITH | CLERK | 7902 | 17-DEC-80 00:00:00 | 800 | | 20

7499 | ALLEN | SALESMAN | 7698 | 20-FEB-81 00:00:00 | 1600 | 300 | 30

7521 | WARD | SALESMAN | 7698 | 22-FEB-81 00:00:00 | 1250 | 500 | 30

7566 | JONES | MANAGER | 7839 | 02-APR-81 00:00:00 | 2975 | | 20

7654 | MARTIN | SALESMAN | 7698 | 28-SEP-81 00:00:00 | 1250 | 1400 | 30

7698 | BLAKE | MANAGER | 7839 | 01-MAY-81 00:00:00 | 2850 | | 30

7782 | CLARK | MANAGER | 7839 | 09-JUN-81 00:00:00 | 2450 | | 10

7788 | SCOTT | ANALYST | 7566 | 19-APR-87 00:00:00 | 3000 | | 20

7839 | KING | PRESIDENT | | 17-NOV-81 00:00:00 | 5000 | | 10

7844 | TURNER | SALESMAN | 7698 | 08-SEP-81 00:00:00 | 1500 | 0 | 30

7876 | ADAMS | CLERK | 7788 | 23-MAY-87 00:00:00 | 1100 | | 20

7900 | JAMES | CLERK | 7698 | 03-DEC-81 00:00:00 | 950 | | 30

7902 | FORD | ANALYST | 7566 | 03-DEC-81 00:00:00 | 3000 | | 20

7934 | MILLER | CLERK | 7782 | 23-JAN-82 00:00:00 | 1300 | | 10

(14 rows)

ポート5444上で実行されているホスト192.168.2.22にあるedbという名前のAdvanced Serverデータベースに、 fdwlink というプライベート・データベース・リンクを作成します。username、 enterprisedbおよびpasswordというパスワードでAdvanced Serverデータベースに接続します 。

CREATE DATABASE LINK fdwlink CONNECT TO enterprisedb IDENTIFIED BY 'password' USING postgres_fdw 'host=192.168.2.22 port=5444 dbname=edb';

ローカルのedb_dblinkシステム・テーブルからデータベース・リンク oralinkおよびfdwlinkの 属性を表示します 。

SELECT lnkname, lnkuser, lnkconnstr FROM pg_catalog.edb_dblink;

 

lnkname | lnkuser | lnkconnstr

---------+--------------+----------------------------------------

oralink | edb | //127.0.0.1:1521/xe

fdwlink | enterprisedb |

(2 rows)

Advanced Serverデータベースのdeptテーブルを使用して、 Oracleデータベースのempテーブルの結合を実行します。

SELECT d.deptno, d.dname, e.empno, e.ename, e.job, e.sal, e.comm FROM emp@oralink e, dept@fdwlink d WHERE e.deptno = d.deptno ORDER BY 1, 3;

 

deptno | dname | empno | ename | job | sal | comm

--------+------------+-------+--------+-----------+------+------

10 | ACCOUNTING | 7782 | CLARK | MANAGER | 2450 |

10 | ACCOUNTING | 7839 | KING | PRESIDENT | 5000 |

10 | ACCOUNTING | 7934 | MILLER | CLERK | 1300 |

20 | RESEARCH | 7369 | SMITH | CLERK | 800 |

20 | RESEARCH | 7566 | JONES | MANAGER | 2975 |

20 | RESEARCH | 7788 | SCOTT | ANALYST | 3000 |

20 | RESEARCH | 7876 | ADAMS | CLERK | 1100 |

20 | RESEARCH | 7902 | FORD | ANALYST | 3000 |

30 | SALES | 7499 | ALLEN | SALESMAN | 1600 | 300

30 | SALES | 7521 | WARD | SALESMAN | 1250 | 500

30 | SALES | 7654 | MARTIN | SALESMAN | 1250 | 1400

30 | SALES | 7698 | BLAKE | MANAGER | 2850 |

30 | SALES | 7844 | TURNER | SALESMAN | 1500 | 0

30 | SALES | 7900 | JAMES | CLERK | 950 |

(14 rows)

ociデータベースリンクのプッシュダウン

oci-dblinkを使用してリモートOracleデータベースでSQL文を実行すると、処理のプッシュダウンが外部サーバで発生する特定の状況があります。

プッシュダウンとは、SQLステートメントが発行されたローカル・クライアントではなく、外部（すなわち、リモート）サーバーでの処理の発生を指します。プッシュダウンは、データがローカル・クライアントに戻される前にリモート・サーバーで処理されるため、パフォーマンスが向上します。

プッシュダウンは、標準のSQL結合操作（内部結合、左外部結合、右外部結合、および完全外部結合）を使用する文に適用されます。結果のデータセットにソートが指定されていてもプッシュダウンが発生します。

プッシュダウンが発生するには、特定の基本条件を満たす必要があります。結合操作に関係する表は、同じ外部サーバーに属し、外部サーバー（つまり、 CREATE DATABASE LINKコマンドで定義された同じデータベース・リンク）と同じ接続情報を使用する必要があります 。

SQL文でプッシュダウンを使用するかどうかを判断するには、 EXPLAINコマンドを使用して実行計画を表示します 。

詳細については 、EXPLAINコマンドにてPostgreSQLのコアのドキュメントを参照してください。

https://www.postgresql.org/docs/11/static/sql-explain.html

次の例では、作成されたデータベースリンクを次のように使用しています。

CREATE PUBLIC DATABASE LINK oralink CONNECT TO edb IDENTIFIED BY 'password' USING '//192.168.2.23:1521/xe';

次の例は、内部結合の実行計画を示しています。

EXPLAIN (verbose,costs off) SELECT d.deptno, d.dname, e.empno, e.ename FROM dept@oralink d, emp@oralink e WHERE d.deptno = e.deptno ORDER BY 1, 3;

 

QUERY PLAN

--------------------------------------------------------------------------------

Foreign Scan

Output: d.deptno, d.dname, e.empno, e.ename

Relations: (_dblink_dept_1 d) INNER JOIN (_dblink_emp_2 e)

Remote Query: SELECT r1.deptno, r1.dname, r2.empno, r2.ename FROM (dept r1 INNER JOIN emp r2 ON ((r1.deptno = r2.deptno))) ORDER BY r1.deptno ASC NULLS LAST, r2.empno ASC NULLS LAST

(4 rows)

INNER JOIN操作は、外部スキャンセクションで行われることに注意してください 。この結合の出力は次のとおりです。

deptno | dname | empno | ename

--------+------------+-------+--------

10 | ACCOUNTING | 7782 | CLARK

10 | ACCOUNTING | 7839 | KING

10 | ACCOUNTING | 7934 | MILLER

20 | RESEARCH | 7369 | SMITH

20 | RESEARCH | 7566 | JONES

20 | RESEARCH | 7788 | SCOTT

20 | RESEARCH | 7876 | ADAMS

20 | RESEARCH | 7902 | FORD

30 | SALES | 7499 | ALLEN

30 | SALES | 7521 | WARD

30 | SALES | 7654 | MARTIN

30 | SALES | 7698 | BLAKE

30 | SALES | 7844 | TURNER

30 | SALES | 7900 | JAMES

(14 rows)

左外部結合の実行計画を以下に示します。

EXPLAIN (verbose,costs off) SELECT d.deptno, d.dname, e.empno, e.ename FROM dept@oralink d LEFT OUTER JOIN emp@oralink e ON d.deptno = e.deptno ORDER BY 1, 3;

 

QUERY PLAN

--------------------------------------------------------------------------------

Foreign Scan

Output: d.deptno, d.dname, e.empno, e.ename

Relations: (_dblink_dept_1 d) LEFT JOIN (_dblink_emp_2 e)

Remote Query: SELECT r1.deptno, r1.dname, r2.empno, r2.ename FROM (dept r1 LEFT JOIN emp r2 ON ((r1.deptno = r2.deptno))) ORDER BY r1.deptno ASC NULLS LAST, r2.empno ASC NULLS LAST

(4 rows)

この結合の出力は次のとおりです。

deptno | dname | empno | ename

--------+------------+-------+--------

10 | ACCOUNTING | 7782 | CLARK

10 | ACCOUNTING | 7839 | KING

10 | ACCOUNTING | 7934 | MILLER

20 | RESEARCH | 7369 | SMITH

20 | RESEARCH | 7566 | JONES

20 | RESEARCH | 7788 | SCOTT

20 | RESEARCH | 7876 | ADAMS

20 | RESEARCH | 7902 | FORD

30 | SALES | 7499 | ALLEN

30 | SALES | 7521 | WARD

30 | SALES | 7654 | MARTIN

30 | SALES | 7698 | BLAKE

30 | SALES | 7844 | TURNER

30 | SALES | 7900 | JAMES

40 | OPERATIONS | |

(15 rows)

次の例は、 emp joinedテーブルが同じ外部サーバではなくローカルに存在するため、処理全体がプッシュダウンされない場合を示しています。

EXPLAIN (verbose,costs off) SELECT d.deptno, d.dname, e.empno, e.ename FROM dept@oralink d LEFT OUTER JOIN emp e ON d.deptno = e.deptno ORDER BY 1, 3;

 

QUERY PLAN

------------------------------------------------------------------

Sort

Output: d.deptno, d.dname, e.empno, e.ename

Sort Key: d.deptno, e.empno

-> Hash Left Join

Output: d.deptno, d.dname, e.empno, e.ename

Hash Cond: (d.deptno = e.deptno)

-> Foreign Scan on _dblink_dept_1 d

Output: d.deptno, d.dname, d.loc

Remote Query: SELECT deptno, dname, NULL FROM dept

-> Hash

Output: e.empno, e.ename, e.deptno

-> Seq Scan on public.emp e

Output: e.empno, e.ename, e.deptno

(13 rows)

この結合の出力は、前の左外部結合の例と同じです。

データベースリンクから外部テーブルを作成する

注意：この項で説明する手順は、Oracleデータベースと互換性がありません。

データベース・リンクを作成した後、このデータベース・リンクに基づいて外部表を作成できます。外部テーブルを使用して、データベースリンク構文を使用する代わりに外部テーブル名を参照するリモートテーブルにアクセスすることができます。データベースリンクを使用するには、 SQLコマンドで参照されるテーブルまたはビュー名に@ dblinkを追加する必要があります。ここで、 dblinkはデータベースリンクの名前です。

このテクニックは、リモートOracleアクセス用のoci-dblink接続、またはリモートPostgresアクセス用のpostgres_fdw接続のいずれかに使用できます。

次の例は、リモートOracle表にアクセスするための外部表の作成を示しています。

まず、前述のようにデータベースリンクを作成します。次に 、Oracleデータベースに接続するためのoralink というデータベース・リンクを作成します。

CREATE PUBLIC DATABASE LINK oralink CONNECT TO edb IDENTIFIED BY 'password' USING '//127.0.0.1:1521/xe';

次のクエリは、データベースリンクを示しています。

SELECT lnkname, lnkuser, lnkconnstr FROM pg_catalog.edb_dblink;

 

lnkname | lnkuser | lnkconnstr

---------+---------+---------------------

oralink | edb | //127.0.0.1:1521/xe

(1 row)

データベースリンクを作成すると、Advanced Serverは対応する外部サーバーを作成します。次のクエリは、外部サーバを表示します。

SELECT srvname, srvowner, srvfdw, srvtype, srvoptions FROM pg_foreign_server;

 

srvname | srvowner | srvfdw | srvtype | srvoptions

---------+----------+--------+---------+-------------------------------

oralink | 10 | 14005 | | {connstr=//127.0.0.1:1521/xe}

(1 row)

外部サーバの詳細については 、PostgreSQL CoreドキュメントのCREATE SERVERコマンドを参照してください 。

https://www.postgresql.org/docs/11/static/sql-createserver.html

次のように外部表を作成します。

CREATE FOREIGN TABLE emp_ora (

empno NUMERIC(4),

ename VARCHAR(10),

job VARCHAR(9),

mgr NUMERIC(4),

hiredate TIMESTAMP WITHOUT TIME ZONE,

sal NUMERIC(7,2),

comm NUMERIC(7,2),

deptno NUMERIC(2)

)

SERVER oralink

OPTIONS (table_name 'emp', schema_name 'edb'

);

CREATE FOREIGN TABLEコマンドでは次の点に注意してください 。

•	で指定した名前 CREATE FOREIGN TABLEコマンドの最後にサーバー句はpg_foreign_server上のクエリからSRVNAME列に表示されているように、この例でoralinkされる外部サーバの名前です。

•	テーブル名とスキーマ名は、 OPTIONS句にtableオプションとschemaオプションで指定します。

•	CREATE FOREIGN TABLEコマンドで指定された列名は、リモート表の列名と一致する必要があります。

•	一般に、 CONSTRAINT節は、リモート表で定義されていると見なされるため、外部表で受け入れられたり強制されたりしないことがあります。

詳細については FOREIGN CREATE TABLEコマンドを、でPostgreSQLのコアのドキュメントを参照してください。

https://www.postgresql.org/docs/11/static/sql-createforeigntable.html

次は外部テーブルのクエリです。

SELECT * FROM emp_ora;

 

empno | ename | job | mgr | hiredate | sal | comm | deptno

-------+--------+-----------+------+--------------------+---------+---------+--------

7369 | SMITH | CLERK | 7902 | 17-DEC-80 00:00:00 | 800.00 | | 20

7499 | ALLEN | SALESMAN | 7698 | 20-FEB-81 00:00:00 | 1600.00 | 300.00 | 30

7521 | WARD | SALESMAN | 7698 | 22-FEB-81 00:00:00 | 1250.00 | 500.00 | 30

7566 | JONES | MANAGER | 7839 | 02-APR-81 00:00:00 | 2975.00 | | 20

7654 | MARTIN | SALESMAN | 7698 | 28-SEP-81 00:00:00 | 1250.00 | 1400.00 | 30

7698 | BLAKE | MANAGER | 7839 | 01-MAY-81 00:00:00 | 2850.00 | | 30

7782 | CLARK | MANAGER | 7839 | 09-JUN-81 00:00:00 | 2450.00 | | 10

7788 | SCOTT | ANALYST | 7566 | 19-APR-87 00:00:00 | 3000.00 | | 20

7839 | KING | PRESIDENT | | 17-NOV-81 00:00:00 | 5000.00 | | 10

7844 | TURNER | SALESMAN | 7698 | 08-SEP-81 00:00:00 | 1500.00 | 0.00 | 30

7876 | ADAMS | CLERK | 7788 | 23-MAY-87 00:00:00 | 1100.00 | | 20

7900 | JAMES | CLERK | 7698 | 03-DEC-81 00:00:00 | 950.00 | | 30

7902 | FORD | ANALYST | 7566 | 03-DEC-81 00:00:00 | 3000.00 | | 20

7934 | MILLER | CLERK | 7782 | 23-JAN-82 00:00:00 | 1300.00 | | 10

(14 rows)

これとは対照的に、以下は外部テーブルの代わりにデータベースリンクを使用して、同じリモートテーブルに対するクエリです。

SELECT * FROM emp@oralink;

 

empno | ename | job | mgr | hiredate | sal | comm | deptno

-------+--------+-----------+------+--------------------+------+------+--------

7369 | SMITH | CLERK | 7902 | 17-DEC-80 00:00:00 | 800 | | 20

7499 | ALLEN | SALESMAN | 7698 | 20-FEB-81 00:00:00 | 1600 | 300 | 30

7521 | WARD | SALESMAN | 7698 | 22-FEB-81 00:00:00 | 1250 | 500 | 30

7566 | JONES | MANAGER | 7839 | 02-APR-81 00:00:00 | 2975 | | 20

7654 | MARTIN | SALESMAN | 7698 | 28-SEP-81 00:00:00 | 1250 | 1400 | 30

7698 | BLAKE | MANAGER | 7839 | 01-MAY-81 00:00:00 | 2850 | | 30

7782 | CLARK | MANAGER | 7839 | 09-JUN-81 00:00:00 | 2450 | | 10

7788 | SCOTT | ANALYST | 7566 | 19-APR-87 00:00:00 | 3000 | | 20

7839 | KING | PRESIDENT | | 17-NOV-81 00:00:00 | 5000 | | 10

7844 | TURNER | SALESMAN | 7698 | 08-SEP-81 00:00:00 | 1500 | 0 | 30

7876 | ADAMS | CLERK | 7788 | 23-MAY-87 00:00:00 | 1100 | | 20

7900 | JAMES | CLERK | 7698 | 03-DEC-81 00:00:00 | 950 | | 30

7902 | FORD | ANALYST | 7566 | 03-DEC-81 00:00:00 | 3000 | | 20

7934 | MILLER | CLERK | 7782 | 23-JAN-82 00:00:00 | 1300 | | 10

(14 rows)

注意：下位互換性の理由から、 USING postgres_fdwではなく、 USING libpqを書くことは可能です。しかし、 libpqコネクタには、 postgres_fdwコネクタに存在する多くの重要な最適化がありません。したがって、 postgres_fdwコネクタは可能な限り使用する必要があります。 libpqオプションは廃止され、将来のAdvanced Serverリリースでは完全に削除される可能性があります。

関連項目

DROP DATABASE LINK

2.3.19 CREATE DIRECTORY

名

CREATE DIRECTORY - ファイルシステムディレクトリパスのエイリアスを作成する

シノプシス

CREATE DIRECTORY name AS ' pathname '

説明

CREATE DIRECTORYコマンドは、ファイルシステムディレクトリのパス名のエイリアスを作成します。このコマンドを使用するには、データベースのスーパーユーザーでなければなりません。

エイリアスが UTL_FILEパッケージのプログラムへの適切なパラメータとして指定されると、オペレーティング・システム・ファイルは、指定されたエイリアスに対応するディレクトリに作成されるか、またはそこからアクセスされます。

パラメーター

名

ディレクトリエイリアス名。

パス名

エイリアス名で表される完全修飾ディレクトリパス。 CREATE DIRECTORYコマンドは、オペレーティングシステムのディレクトリを作成しません。物理ディレクトリは、適切なオペレーティングシステムコマンドを使用して個別に作成する必要があります。

ノート

ディレクトリを使用してファイルを作成および/または読み取るためにUTL_FILEパッケージを使用する場合は、 オペレーティング・システムのユーザーID enterprisedbに、ディレクトリに対する適切な読取り権限および/または書込み権限が必要です。

ディレクトリエイリアスは、 pg_catalog.edb_dirシステムカタログテーブルに格納されてい ます 。 edb_dirはOracleデータベースと互換性のある表ではありません。

ディレクトリ・エイリアスは 、Oracleデータベースと互換性のあるSYS.ALL_DIRECTORIESおよびSYS.DBA_DIRECTORIES というOracleカタログ・ビューからも参照できます。

ディレクトリエイリアスを削除するには、 DROP DIRECTORYコマンドを使用します。ディレクトリエイリアスが削除されると、対応する物理ファイルシステムディレクトリは影響を受けません。ファイルシステムディレクトリは、適切なオペレーティングシステムコマンドを使用して削除する必要があります。

Linuxシステムでは、ディレクトリ名の区切り文字はスラッシュ（ / ）です。

Windowsシステムでは、ディレクトリ名の区切り文字をスラッシュ（ / ）または2つの連続する円記号（ ¥¥ ） として指定できます 。

例

Linuxの場合 、ディレクトリ/ tmp / empdirの empdir というエイリアスを作成します 。

CREATE DIRECTORY empdir AS '/tmp/empdir';

Windowsでは、 C：¥TEMP¥EMPDIRディレクトリの別名 empdirを作成します。

CREATE DIRECTORY empdir AS 'C:/TEMP/EMPDIR';

すべてのディレクトリエイリアスを表示します。

SELECT * FROM pg_catalog.edb_dir;

 

dirname | dirowner | dirpath | diracl

---------+----------+----------------+--------

empdir | 10 | C:/TEMP/EMPDIR |

(1 row)

Oracleデータベースと互換性のあるビューを使用して、ディレクトリ別名を表示します。

SELECT * FROM SYS.ALL_DIRECTORIES;

 

owner | directory_name | directory_path

--------------+----------------+----------------

ENTERPRISEDB | EMPDIR | C:/TEMP/EMPDIR

(1 row)

関連項目

DROP DIRECTORY

 

2.3.20 CREATE FUNCTION

名

CREATE FUNCTION - 新しい関数を定義する

シノプシス

CREATE [ OR REPLACE ] FUNCTION name [ ( parameters ) ]

RETURN data_type

[

不変
|安定
|揮発性
|決定的
| [NOT] LEAKPROOF

| NULL入力で呼び出される
|ヌル入力でNULLを返す
| STRICT

| [外部]セキュリティ・インボーカ
| [外部]セキュリティディフェンダー

| AUTHID DEFINER
| AUTHID CURRENT_USER

|パラレル{UNSAFE |制限された|安全 }

| COSTの 実行 _ コスト

| ROWSは _ 行の 結果
| SET 構成 _ パラメーター
{TO 値 | = 値 | FROM CURRENT}
...]
{IS | AS}

[PRAGMA AUTONOMOUS_TRANSACTION; ]

[ declarations ]

BEGIN

statements

END [ name ];

 

説明

CREATE FUNCTIONは新しい関数を定義します。 CREATE OR REPLACE FUNCTIONは、新しい関数を作成するか、既存の定義を置き換えます。

スキーマ名が含まれる場合、関数は指定されたスキーマに作成されます。それ以外の場合は、現在のスキーマに作成されます。新しい関数の名前は、同じスキーマ内の同じ入力引数型を持つ既存の関数と一致していてはなりません。しかし、異なる入力引数型の関数は名前を共有することがあります（これは オーバーロード と呼ばれます ）。 （関数のオーバーロードはAdvanced Serverの機能です。格納されたスタンドアロン関数のオーバーロードはOracleデータベースと互換性がありません。

既存の関数の定義を更新するには、 CREATE OR REPLACE FUNCTIONを 使用します 。この方法で関数の名前や引数の型を変更することはできません（試した場合は、実際には別個の関数を作成することになります）。また、 CREATE OR REPLACE FUNCTIONでは、既存の関数の戻り値の型を変更することはできません。これを行うには、関数を削除して再作成する必要があります。また、 OUTパラメーターを使用する場合は、その関数をドロップすることを除いて、 OUTパラメーターのタイプを変更することはできません。

関数を作成するユーザーは、関数の所有者になります。

パラメーター

名

name は関数の識別子です 。

パラメーター

parameters は仮パラメータのリストです。

データ・タイプ

data_typeは、関数のRETURNステートメントによって返された値のデータ型です。

宣言

宣言 は、変数、カーソル、型、または副プログラムの宣言です。サブプログラム宣言が含まれている場合は、他のすべての変数宣言、カーソル宣言、および型宣言の後に宣言する必要があります。

ステートメント

ステートメント は SPL プログラムステートメントです（ BEGIN - END ブロックには EXCEPTIONセクションが含まれる場合があります ）。

不変

安定

揮発性

これらの属性は、クエリオプティマイザに関数の動作を通知します 。 1つの選択肢しか指定できません。 VOLATILE はデフォルトの動作です。

IMMUTABLE は、関数がデータベースを変更できず、同じ引数値が与えられたときに常に同じ結果に達することを示します。データベース参照を行わず、引数リストに直接存在しない情報を使用しません。この句を含める と、すべて定数の引数を持つ関数の呼び出しを すぐに関数の値 に置き換えることができ ます。

STABLE は、関数がデータベースを変更できない ことを示し 、単一の表スキャン内では、同じ引き数値に対して同じ結果を一貫して戻しますが、結果はSQLステートメント全体で変更される可能性があることを示します。これは、 データベースルックアップ、パラメータ変数（現在のタイムゾーンなど）に依存する関数の適切な選択です 。

VOLATILE は 、単一のテーブル・スキャン内でも関数値が変更できることを 示している ため、最適化は行えません。副作用のある関数は、呼び出しが最適化されないように、結果がかなり予測可能であっても、揮発性に分類されなければならないことに注意してください。

決定的

DETERMINISTICはIMMUTABLEの同義語です。 DETERMINISTIC関数はデータベースを変更することはできず、同じ引き数を指定すると常に同じ結果になります。データベース参照を行わず、引数リストに直接存在しない情報を使用しません。この句を含めると、すべて定数の引数を持つ関数の呼び出しをすぐに関数の値に置き換えることができます。

[NOT] LEAKPROOF

漏れ止め 関数には副作用がなく、関数の呼び出しに使用された値に関する情報は表示されません 。

NULL入力で呼び出される
ヌル入力でNULLを返す
STRICT

呼び出される に ヌル INPUT （デフォルト）は、引数の一部が NULLの 場合にプロシージャが正常に呼び出されることを示し ます 。 必要に応じ て NULL 値 をチェックし、 適切に応答するの は作者の責任 です。

戻り値 ヌル に ヌル INPUT または STRICT は 、その引数のいずれか が NULL の場合は必ずプロシージャが NULL を返すことを示し ます 。これらの句が指定されている場合、 NULL 引数 がある場合はプロシージャは実行されません 。代わりに NULL という結果が自動的想定されます。

[外部]セキュリティディフェンダー

セキュリティ DEFINER は、関数を作成したユーザーの権限で関数が実行されることを指定します。これがデフォルトです。キーワード EXTERNAL はSQL準拠には使用できますが、オプションです。

[外部]セキュリティ・インボーカ

SECURITY INVOKER 句は、関数を呼び出すユーザーの権限で関数が実行されることを示します。キーワード EXTERNAL はSQL準拠には使用できますが、オプションです。

AUTHID DEFINER

AUTHID CURRENT_USER

AUTHID DEFINER 句は、 [EXTERNAL]の 同義語です 。 セキュリティ DEFINER 。 AUTHID 句が省略された 場合 、または AUTHID 場合 DEFINER が指定されている場合、関数所有者の権限を使用してデータベース・オブジェクトへのアクセス権限が決定されます。

AUTHID CURRENT_USER 句は、 [EXTERNAL]の 同義語です 。 セキュリティ INVOKER 。 AUTHIDの 場合 CURRENT_USER が指定されている場合、その関数を実行している現行ユーザーの権限を使用してアクセス特権が判別されます。

パラレル{UNSAFE |制限された|安全 }

PARALLEL 句は、並列逐次走査（パラレルモード）の使用を可能にします。 並列逐次スキャンは、逐次逐次スキャンとは対照的に、クエリ中に複数のワーカーを使用してリレーションを並行してスキャンします。

UNSAFE に 設定すると 、パラレルモードでは実行できません。このような関数がSQL文に存在すると、実行計画が強制的に実行されます。これは、 PARALLEL 句が省略された 場合のデフォルト設定です 。

RESTRICTED に 設定すると 、この関数はパラレルモードで実行できますが、実行はパラレルグループリーダーに制限されます。特定の関係の資格に並行制限があるものがあれば、その関係は並列性のために選択されません。

SAFE に 設定すると 、パラレルモードで機能を制限なく実行できます。

COSTの 実行 _ コスト

実行 _ コスト は、 CPUの _ 演算子 _ コストの 単位で 、関数の推定実行コストを示す正の数 です。機能の場合 セットを返します。返される行あたりのコストです。値を大きくすると、プランナは関数の評価を回避しようとします 必要以上に頻繁に。

ROWSは _ 行の 結果

result _ rows は、プランナが関数を予想する行の推定数を示す正の数です。 復帰する。これは、関数 セットを返すように宣言されています。デフォルトの仮定は1000行です。

SET 設定 _ パラメータ {TO 値 | = 値 | FROM CURRENT}

SET 句は、場合関数指定された構成パラメータが指定された値に設定させます 関数が入力されると、その値に戻されます 終了します。 セット から CURRENT は、セッションの現在のパラメータ値を、関数の実行時に適用される値として保存します 入力されます。

場合は SET 句は、関数、SETの後、効果 に取り付けられています。 関数内で実行される LOCAL コマンド 同じ変数に対しては関数に制限されています。構成パラメータの以前の値が関数で復元される 出口。 （LOCALなし ） 通常の SET コマンドは 、前の SET のために行うだろう限り、SET句を 上書きします 現在のトランザクションがロールバックされない限り、プロシージャの終了後にそのようなコマンドの効果が持続する LOCAL コマンド。

PRAGMA AUTONOMOUS_TRANSACTION

PRAGMA AUTONOMOUS_TRANSACTIONは、この関数を自律型トランザクションとして設定するディレクティブです。

注： STRICT 、 LEAKPROOF 、 PARALLEL 、 COST 、 ROWSおよびSETキーワードはAdvanced Serverの拡張機能を提供し、Oracleではサポートされていません。

ノート

Advanced Serverでは、関数のオーバーロードが可能です。つまり、異なる入力関数（ IN 、 IN OUT ）引数データ型を持つ限り、同じ名前を複数の異なる関数に使用できます。

例

関数 emp_compは、2つの数値を入力として取り、計算値を返します。 SELECTコマンドは、関数の使用方法を示します。

CREATE OR REPLACE FUNCTION emp_comp (

p_sal NUMBER,

p_comm NUMBER

) RETURN NUMBER

IS

BEGIN

RETURN (p_sal + NVL(p_comm, 0)) * 24;

END;

 

SELECT ename "Name", sal "Salary", comm "Commission", emp_comp(sal, comm)

"Total Compensation" FROM emp;

 

Name | Salary | Commission | Total Compensation

--------+---------+------------+--------------------

SMITH | 800.00 | | 19200.00

ALLEN | 1600.00 | 300.00 | 45600.00

WARD | 1250.00 | 500.00 | 42000.00

JONES | 2975.00 | | 71400.00

MARTIN | 1250.00 | 1400.00 | 63600.00

BLAKE | 2850.00 | | 68400.00

CLARK | 2450.00 | | 58800.00

SCOTT | 3000.00 | | 72000.00

KING | 5000.00 | | 120000.00

TURNER | 1500.00 | 0.00 | 36000.00

ADAMS | 1100.00 | | 26400.00

JAMES | 950.00 | | 22800.00

FORD | 3000.00 | | 72000.00

MILLER | 1300.00 | | 31200.00

(14 rows)

関数 sal_rangeは、給与が指定された範囲内にある従業員の数のカウントを返します。次の無名ブロックは、引数の最初の2つの呼び出しのデフォルト値を使用して関数を何度も呼び出します。

CREATE OR REPLACE FUNCTION sal_range (

p_sal_min NUMBER DEFAULT 0,

p_sal_max NUMBER DEFAULT 10000

) RETURN INTEGER

IS

v_count INTEGER;

BEGIN

SELECT COUNT(*) INTO v_count FROM emp

WHERE sal BETWEEN p_sal_min AND p_sal_max;

RETURN v_count;

END;

 

BEGIN

DBMS_OUTPUT.PUT_LINE('Number of employees with a salary: ' ||

sal_range);

DBMS_OUTPUT.PUT_LINE('Number of employees with a salary of at least '

|| '$2000.00: ' || sal_range(2000.00));

DBMS_OUTPUT.PUT_LINE('Number of employees with a salary between '

|| '$2000.00 and $3000.00: ' || sal_range(2000.00, 3000.00));

 

END;

 

Number of employees with a salary: 14

Number of employees with a salary of at least $2000.00: 6

Number of employees with a salary between $2000.00 and $3000.00: 5

次の例は、関数宣言でAUTHID CURRENT_USER句とSTRICTキーワードを使用する方法を示しています。

CREATE OR REPLACE FUNCTION dept_salaries(dept_id int) RETURN NUMBER

STRICT

AUTHID CURRENT_USER

BEGIN

RETURN QUERY (SELECT sum(salary) FROM emp WHERE deptno = id);

END;

渡された入力パラメーターが NULLの 場合 、サーバーに NULL を戻すように指示 する STRICT キーワードを 組み込み ます 。 NULL 値 が渡された 場合 、この関数は実行されません。

DEPT _ 給与の 関数は、関数を呼び出している役割の権限で実行されます。 現在のユーザーに 、 （従業員の給与を表示 するために） emp 表を 照会する SELECT ステートメント を実行するための十分な特権がない場合、 関数はエラーを報告します。関数を定義したロールに関連付けられた権限を使用するようにサーバーに指示するには、 AUTHID AUTHIDを 持つ CURRENT _ USER 節 DEFINER 句。

その他のプラグマ（パッケージ仕様内で宣言されている）

PRAGMA RESTRICT_REFERENCES

Advanced Serverは受け入れますが、構文参照無視 プラグマは _ の参照を 制限します 。

関連項目 DROP FUNCTION

 

2.3.21 CREATE INDEX

名

CREATE INDEX - 新しいインデックスを定義する

シノプシス

CREATE [ UNIQUE ] INDEX name ON table

( { column | ( expression ) } )

[ TABLESPACE tablespace ]

説明

CREATE INDEXは、指定された表の索引nameを構成します。索引は主にデータベースのパフォーマンスを向上させるために使用されます（不適切な使用はパフォーマンスが低下します）。

索引のキー・フィールドは、列名、あるいはかっこで書かれた式として指定されます。複数のフィールドを指定すると、複数の列のインデックスを作成できます。

インデックスフィールドは、テーブル行の1つ以上の列の値から計算された式です。この機能を使用して、基本データの一部の変換に基づいてデータへの高速アクセスを取得できます。たとえば、 UPPER（col）で 計算されたインデックスは、 WHERE UPPER（col）= 'JIM'という句でインデックスを使用できます。

Advanced Serverは、Bツリーのインデックス方法を提供します 。 Bツリーインデックスメソッドは、Lehman-Yaoの高並列Bツリーの実装です。

索引は 、デフォルトで IS NULL句には使用されません 。

インデックス定義で使用されるすべての関数と演算子は、「不変」でなければなりません。つまり、結果は引数にのみ依存し、外部の影響（他のテーブルの内容や現在の時刻など）には依存しません。この制限により、索引の動作が適切に定義されます。インデックス式でユーザー定義関数を使用するには、関数を作成するときにその関数を不変にすることを忘れないでください。

パーティション表に索引を作成すると、 CREATE INDEXコマンドは索引を表のサブパーティションに伝播します。

パラメーター

ユニーク

索引が作成されたとき（データがすでに存在する場合）およびデータが追加されるたびに、システムが表内の重複値を検査するようにします。重複した結果となるデータを挿入または更新しようとすると、エラーが発生します。

名

作成する索引の名前。ここにはスキーマ名は含まれません。索引は常に親表と同じスキーマに作成されます。

表

索引付けする表の名前（スキーマ修飾名）。

カラム

表内の列の名前。

表現

表の1つ以上の列に基づく式。式は通常、構文で示されているように、囲む括弧で書かれていなければなりません。ただし、式に関数呼び出しの形式がある場合は、かっこは省略することができます。

表スペース

索引を作成する表領域。指定されていない場合は、 DEFAULT_TABLESPACEは空の文字列である場合DEFAULT_TABLESPACEを使用、またはデータベースのデフォルトの表領域です。

ノート

複数列の索引では、最大32のフィールドを指定できます。

例

列にB-treeインデックスを作成するには、 ENAME、テーブルで、EMP：

CREATE INDEX name_idx ON emp (ename);

上記と同じインデックスを作成しますが、 index_tblspcテーブルスペースに存在させるには ：

CREATE INDEX name_idx ON emp (ename) TABLESPACE index_tblspc;

関連項目

DROP INDEX 、 ALTER INDEX

 

2.3.22 MATERIALIZED VIEWの作成

名

CREATE MATERIALIZED VIEW - 新しいマテリアライズド・ビューを定義する

シノプシス

CREATE MATERIALIZED VIEW name
[ build _ clause ][ create _ mv _ refresh ] AS subquery

どこ ビルド _ 句は 次のとおりです。

ビルド{IMMEDIATE | DEFERRED}

作成 _ _ MV リフレッシュは 次 のように なります。

リフレッシュ[完了] [オンデマンド]

説明

CREATE MATERIALIZED VIEWは、クエリでビューが参照されるたびに更新されないクエリのビューを定義します。デフォルトでは、ビューが作成されるとビューに値が設定されます。 BUILD DEFERREDキーワードを含めると、ビューの作成を遅らせることができます。

マテリアライズド・ビューはスキーマで修飾されている場合があります。 CREATE MATERIALIZED VIEWコマンドを呼び出すときにスキーマ名を指定すると、指定したスキーマにビューが作成されます。ビュー名は、同じスキーマ内の他のビュー、テーブル、シーケンス、またはインデックスの名前とは異なるものでなければなりません。

パラメーター

名

作成されるビューの名前（スキーマ修飾名も可）

サブクエリ

ビューの内容を指定する SELECTステートメント。有効な照会の詳細については、 SELECTを参照してください。

build_clause

含めるビューを移入する必要があるときに指定するbuild_clauseを 。 BUILD IMMEDIATEまたはBUILD DEFERREDを指定する：

•	BUILD IMMEDIATEは、ビューに直ちにデータを設定するようにサーバーに指示します。これがデフォルト動作です。

•	BUILD DEFERREDは、後で（ REFRESH操作中に）ビューを移入するようにサーバーに指示します。

create_mv_refresh

マテリアライズド・ビューの内容をいつ更新するかを指定するには、 create_mv_refresh句を含めます 。この節には、 REFRESHキーワードの後にCOMPLETEおよび/またはON DEMANDが続きます。

•	COMPLETEは、現行のコンテンツを破棄し、マテリアライズド・ビューをリフレッシュするときにビューの定義問合せを実行して、マテリアライズド・ビューをリロードするようにサーバーに指示します。

•	ON DEMANDは、 DBMS _ MVIEWパッケージを呼び出すか、Postgres REFRESH MATERIALIZED VIEW文を呼び出すことによって、オンデマンドでマテリアライズド・ビューをリフレッシュするようサーバーに指示します。これがデフォルト動作です。

ノート

マテリアライズド・ビューは読取り専用です。サーバーはビューに対して INSERT 、 UPDATEまたはDELETEを許可しません 。

ビューで参照されるテーブルへのアクセスは、ビュー所有者の権限によって決定されます。 ビューのユーザーは、ビューで使用されるすべての関数を呼び出すための権限を持っている必要があります。

Postgres REFRESH MATERIALIZED VIEW コマンドの詳細については、以下のPostgreSQLコアドキュメントを参照してください。

https://www.postgresql.org/docs/11/static/sql-refreshmaterializedview.html

例

次の文は、 dept_30 というマテリアライズド・ビューを作成します 。

CREATE MATERIALIZED VIEW dept_30 BUILD IMMEDIATE AS SELECT * FROM emp WHERE deptno = 30;

このビューには 、部門 30 で働く従業員に関する emp テーブル から取得された情報が含まれています 。

 

2.3.23 パッケージの作成

名

CREATE PACKAGE - 新しいパッケージ仕様を定義する

シノプシス

CREATE [ OR REPLACE ] PACKAGE name

[ AUTHID { DEFINER | CURRENT_USER } ]

{ IS | AS }

[ declaration ; ] [, ...]

[ { PROCEDURE proc_name

[ ( argname [ IN | IN OUT | OUT ] argtype [ DEFAULT value ]

[, ...]) ];

[ PRAGMA RESTRICT_REFERENCES( name ,

{ RNDS | RNPS | TRUST | WNDS | WNPS } [, ... ] ); ]

|

FUNCTION func_name

[ ( argname [ IN | IN OUT | OUT ] argtype [ DEFAULT value ]

[, ...]) ]

RETURN rettype [ DETERMINISTIC ];

[ PRAGMA RESTRICT_REFERENCES( name ,

{ RNDS | RNPS | TRUST | WNDS | WNPS } [, ... ] ); ]

}

] [, ...]

END [ name ]

説明

CREATE PACKAGEは新しいパッケージ仕様を定義します。 CREATE OR REPLACE PACKAGEは新しいパッケージ仕様を作成するか、既存の仕様を置き換えます。

スキーマ名が含まれている場合、パッケージは指定されたスキーマに作成されます。それ以外の場合は、現在のスキーマに作成されます。新しいパッケージの名前は、既存のパッケージの定義を更新する場合を除き、同じスキーマ内の既存のパッケージと一致していてはなりません（その場合は CREATE OR REPLACE PACKAGEを 使用します） 。

プロシージャを作成するユーザーは、パッケージの所有者になります。

パラメーター

名

作成するパッケージの名前（スキーマ修飾名でも可）。

DEFINER |現在の使用者

パッケージ所有者（ DEFINER ）の権限またはパッケージ内のプログラムを実行している現行ユーザーの権限（ CURRENT_USER ）を使用して、パッケージで参照されるデータベース・オブジェクトへのアクセスが許可されているかどうかを指定します。 DEFINERがデフォルトです。

宣言

パブリック変数、型、カーソル、または REF CURSOR宣言。

proc_name

パブリックプロシージャーの名前。

argname

引数の名前。

IN | IN OUT |でる

引数モード。

argtype

プログラムの引数のデータ型。

DEFAULT 値

入力引数のデフォルト値。

func_name

パブリック関数の名前。

rettype

戻り値のデータ型。

決定的

DETERMINISTICはIMMUTABLEの同義語です。 DETERMINISTIC プロシージャーはデータベースを変更することはできず、同じ引き数値が与えられたときに常に同じ結果になります。データベース参照を行わず、引数リストに直接存在しない情報を使用しません。この句をインクルードすると、すべて定数の引数を持つプロシージャの呼び出しをすぐにプロシージャの値に置き換えることができます。

RNDS | RNPS |トラスト| WNDS | WNPS

キーワードは互換性のために受け入れられ、無視されます。

例

パッケージの仕様 empinfoには、パブリック変数、パブリック・プロシージャ、パブリック関数の3つのパブリック・コンポーネントが含まれています。

CREATE OR REPLACE PACKAGE empinfo

IS

emp_name VARCHAR2(10);

PROCEDURE get_name (

p_empno NUMBER

);

FUNCTION display_counter

RETURN INTEGER;

END;

関連項目

パッケージを削除する

 

2.3.24 パッケージの作成

名

CREATE BODY PACKAGE - 新しいパッケージ本体を定義する

シノプシス

CREATE [ OR REPLACE ] PACKAGE BODY name

{ IS | AS }

[ declaration ; ] [, ...]

[ { PROCEDURE proc_name

[ ( argname [ IN | IN OUT | OUT ] argtype [ DEFAULT value ]

[, ...]) ]

[ STRICT ]

[ LEAKPROOF ]

[ PARALLEL { UNSAFE | RESTRICTED | SAFE } ]

[ COST execution_cost ]

[ ROWS result_rows ]

[ SET config_param { TO value | = value | FROM CURRENT } ]

{ IS | AS }

program_body

END [ proc_name ];

|

FUNCTION func_name

[ ( argname [ IN | IN OUT | OUT ] argtype [ DEFAULT value ]

[, ...]) ]

RETURN rettype [ DETERMINISTIC ]

[ STRICT ]

[ LEAKPROOF ]

[ PARALLEL { UNSAFE | RESTRICTED | SAFE } ]

[ COST execution_cost ]

[ ROWS result_rows ]

[ SET config_param { TO value | = value | FROM CURRENT } ]

{ IS | AS }

program_body

END [ func_name ];

}

] [, ...]

[ BEGIN

statement ; [, ...] ]

END [ name ]

説明

CREATE PACKAGE BODYは新しいパッケージ本体を定義します。 CREATE OR REPLACE PACKAGE BODYは、新しいパッケージ本体を作成するか、既存の本体を置き換えます。

スキーマ名が含まれている場合、指定されたスキーマにパッケージ本体が作成されます。それ以外の場合は、現在のスキーマに作成されます。新しいパッケージ本体の名前は、同じスキーマ内の既存のパッケージ仕様と一致する必要があります。新しいパッケージの本体名は、既存のパッケージ本体の定義を更新する場合を除いて、同じスキーマ内の既存のパッケージ本体と一致していてはなりません 。 その場合は CREATE OR REPLACE PACKAGE BODYを使用してください 。

パラメーター

名

作成するパッケージ本体の名前（スキーマ修飾名でも可）。

宣言

専用変数、型、カーソル、または REF CURSOR宣言。

proc_name

公開または非公開のプロシージャーの名前。 proc_nameが同一のシグネチャを持つパッケージ仕様に存在する場合 、それはパブリックです。それ以外の場合はプライベートです。

argname

引数の名前。

IN | IN OUT |でる

引数モード。

argtype

プログラムの引数のデータ型。

DEFAULT 値

入力引数のデフォルト値。

STRICT

STRICTキーワードは、NULL引数で呼び出された場合、関数が実行されないことを指定します。 代わりに関数は NULL を返し ます 。

漏れ防止

漏れ防止のキーワードは、関数が戻り値を介する以外の引数、についての情報を明らかにしないことを指定します。

パラレル{UNSAFE |制限された|安全 }

PARALLEL 句は、並列逐次走査（パラレルモード）の使用を可能にします。 並列逐次スキャンは、逐次逐次スキャンとは対照的に、クエリ中に複数のワーカーを使用してリレーションを並行してスキャンします。

UNSAFE に 設定する と、プロシージャまたはファンクションをパラレルモードで実行できません。このようなプロシージャまたはファンクションが存在すると、連続した実行計画が強制されます。これは、 PARALLEL 句が省略された 場合のデフォルト設定です 。

RESTRICTED に 設定する と、プロシージャまたはファンクションはパラレル・モードで実行できますが、実行はパラレル・グループ・リーダに制限されます。特定の関係の資格に並行制限があるものがあれば、その関係は並列性のために選択されません。

SAFE に 設定されている場合 、手続きまたは関数は制限なしでパラレルモードで実行できます。

execution_cost

execution_costは、 cpu_operator_costの単位で関数の推定実行コストを示す正の数を指定します。関数がセットを返す場合、これは返される行あたりのコストです。デフォルトは0.0025です。

result_rows

result_rowsは、クエリプランナが関数が返すと予想する行の推定数です。デフォルトは1000です。

セット

関数の持続時間のパラメータ値を指定するには、 SET句を使用します。

config_param は、パラメータ名を指定します。

value はパラメータ 値を 指定します。

FROM CURRENT は、関数の終了時にパラメーター値が復元されることを保証します。

program_body

関数またはプロシージャーの本体を構成するプラグマ、宣言、および SPLステートメント。

PRAGMA AUTONOMOUS_TRANSACTIONは、機能またはプロシージャを自律型トランザクションとして設定するためのプラグマです。

宣言には、変数、型、 REF CURSOR 、またはサブプログラムの宣言が含まれます 。 サブプログラム宣言が含まれている場合は、他のすべての変数、型、および REF CURSOR 宣言の 後に宣言する必要があり ます 。

func_name

パブリック関数またはプライベート関数の名前。 func_nameが同一のシグネチャを持つパッケージ仕様に存在する場合 、それはパブリックです。それ以外の場合はプライベートです。

rettype

戻り値のデータ型。

決定的

DETERMINISTICをインクルードして 、同じ引数値が指定されたときに関数が常に同じ結果を返すように指定します。 DETERMINISTIC関数は、データベースを変更してはいけません。

注： DETERMINISTICキーワードは、PostgreSQLのIMMUTABLEオプションと同等です。

注：パッケージ本体のパブリック関数にDETERMINISTICが指定されている場合は、パッケージ仕様の関数宣言にも指定する必要があります。プライベート関数の場合、パッケージ仕様に関数宣言はありません。

ステートメント

SPLプログラム文です。パッケージ初期化セクションのステートメントは、パッケージが初めて参照されたときにセッションごとに1回実行されます。

注： STRICT 、 LEAKPROOF 、 PARALLEL 、 COST 、 ROWSおよびSETキーワードはAdvanced Serverの拡張機能を提供し、Oracleではサポートされていません。

例

以下は、 empinfoパッケージのパッケージ本体です 。

CREATE OR REPLACE PACKAGE BODY empinfo

IS

v_counter INTEGER;

PROCEDURE get_name (

p_empno NUMBER

)

IS

BEGIN

SELECT ename INTO emp_name FROM emp WHERE empno = p_empno;

v_counter := v_counter + 1;

END;

FUNCTION display_counter

RETURN INTEGER

IS

BEGIN

RETURN v_counter;

END;

BEGIN

v_counter := 0;

DBMS_OUTPUT.PUT_LINE('Initialized counter');

END;

次の2つの無名ブロックは、 empinfoパッケージのプロシージャと関数を実行し 、パブリック変数を表示します。

BEGIN

empinfo.get_name(7369);

DBMS_OUTPUT.PUT_LINE('Employee Name : ' || empinfo.emp_name);

DBMS_OUTPUT.PUT_LINE('Number of queries: ' || empinfo.display_counter);

END;

 

Initialized counter

Employee Name : SMITH

Number of queries: 1

 

BEGIN

empinfo.get_name(7900);

DBMS_OUTPUT.PUT_LINE('Employee Name : ' || empinfo.emp_name);

DBMS_OUTPUT.PUT_LINE('Number of queries: ' || empinfo.display_counter);

END;

 

Employee Name : JAMES

Number of queries: 2

関連項目

パッケージの作成 、 パッケージの削除

2.3.25作成手順

名

CREATE PROCEDURE - 新しいストアドプロシージャを定義する

シノプシス

CREATE [ OR REPLACE ] PROCEDURE name [ ( parameters ) ]
[

不変
|安定
|揮発性
|決定的
| [NOT] LEAKPROOF

| NULL入力で呼び出される
|ヌル入力でNULLを返す
| STRICT

| [外部]セキュリティ・インボーカ
| [外部]セキュリティディフェンダー

| AUTHID DEFINER
| AUTHID CURRENT_USER

|パラレル{UNSAFE |制限された|安全 }

| COSTの 実行 _ コスト

| ROWSは _ 行の 結果
| SET 構成 _ パラメーター
{TO 値 | = 値 | FROM CURRENT}
...]
{IS | AS}

[PRAGMA AUTONOMOUS_TRANSACTION; ]

[ declarations ]

BEGIN

statements

END [ name ];

説明

CREATE PROCEDUREは、新しいストアド・プロシージャーを定義します。 CREATE OR REPLACE PROCEDUREは、新しいプロシージャを作成するか、既存の定義を置き換えます。

スキーマ名が含まれている場合、プロシージャーは指定されたスキーマに作成されます。それ以外の場合は、現在のスキーマに作成されます。新しいプロシージャの名前は、同じスキーマ内の同じ入力引数型を持つ既存のプロシージャと一致していてはなりません。しかし、異なる入力引数型のプロシージャは名前を共有することがあります（これは オーバーロード と呼ばれます ）。 （プロシージャのオーバーロードはAdvanced Serverの機能であり、ストアド・スタンドアロン・プロシージャのオーバーロードはOracleデータベースと互換性がありません）。

既存のプロシージャーの定義を更新するには、 CREATE OR REPLACE PROCEDUREを 使用します 。このようにプロシージャの名前または引数の型を変更することはできません（試した場合は、実際には新しいプロシージャを作成することになります）。 OUTパラメーターを使用する場合は、プロシージャーをドロップすることを除いて、 OUTパラメーターのタイプを変更することはできません。

パラメーター

名

name はプロシージャの識別子です。

パラメーター

parameters は仮パラメータのリストです。

宣言

宣言 は、変数、カーソル、型、または副プログラムの宣言です。サブプログラム宣言が含まれている場合は、他のすべての変数宣言、カーソル宣言、および型宣言の後に宣言する必要があります。

ステートメント

ステートメント は SPL プログラムステートメントです（ BEGIN - END ブロックには EXCEPTIONセクションが含まれる場合があります ）。

不変

安定

揮発性

これらの属性は、問合せオプティマイザにプロシージャの動作を通知します。 1つの選択肢しか指定できません。 VOLATILE はデフォルトの動作です。

IMMUTABLE は、プロシージャーがデータベースを変更できず、同じ引き数値が与えられたときに常に同じ結果に達することを示します。データベース参照を行わず、引数リストに直接存在しない情報を使用しません。この句をインクルードすると、すべて定数の引数を持つプロシージャの呼び出しをすぐにプロシージャの値に置き換えることができます。

STABLE は、プロシージャーがデータベースを変更できず、単一の表スキャン内で、同じ引き数値に対して同じ結果を一貫して戻しますが、結果がSQLステートメントで変更される可能性があることを示します。これは、データベースルックアップ、パラメータ変数（現在のタイムゾーンなど）に依存するプロシージャの適切な選択です。

VOLATILE は、単一の表スキャン内でもプロシージャ値が変更可能であるため、最適化を実行できないことを示します。副作用のある関数は、呼び出しが最適化されないように、結果がかなり予測可能であっても、揮発性に分類されなければならないことに注意してください。

決定的

DETERMINISTICはIMMUTABLEの同義語です。 DETERMINISTIC プロシージャーはデータベースを変更することはできず、同じ引き数値が与えられたときに常に同じ結果になります。データベース参照を行わず、引数リストに直接存在しない情報を使用しません。この句をインクルードすると、すべて定数の引数を持つプロシージャの呼び出しをすぐにプロシージャの値に置き換えることができます。

[NOT] LEAKPROOF

漏れ防止の 手順は、副作用がなく、プロシージャを呼び出すために使用される値に関する情報を明らかにしません。

NULL入力で呼び出される
ヌル入力でNULLを返す
STRICT

呼び出される に ヌル INPUT （デフォルト）は、引数の一部が NULLの 場合にプロシージャが正常に呼び出されることを示し ます 。 必要に応じ て NULL 値 をチェックし、 適切に応答するの は作者の責任 です。

戻り値 ヌル に ヌル INPUT または STRICT は 、その引数のいずれか が NULL の場合は必ずプロシージャが NULL を返すことを示し ます 。これらの句が指定されている場合、 NULL 引数 がある場合はプロシージャは実行されません 。代わりに NULL という結果が自動的想定されます。

[外部]セキュリティディフェンダー

セキュリティ DEFINER は、プロシージャを作成したユーザーの権限でプロシージャを実行するように指定します。これがデフォルトです。キーワード EXTERNAL はSQL準拠には使用できますが、オプションです。

[外部]セキュリティ・インボーカ

SECURITY INVOKER 句は、プロシージャがそれを呼び出すユーザの権限で実行されることを示します。キーワード EXTERNAL はSQL準拠には使用できますが、オプションです。

AUTHID DEFINER

AUTHID CURRENT_USER

AUTHID DEFINER 句は、 [EXTERNAL]の 同義語です 。 セキュリティ DEFINER 。 AUTHID 句が省略された 場合 、または AUTHID 場合 DEFINER が指定されている場合は、プロシージャ所有者の権限を使用してデータベース・オブジェクトへのアクセス権限が決定されます。

AUTHID CURRENT_USER 句は、 [EXTERNAL]の 同義語です 。 セキュリティ INVOKER 。 AUTHIDの 場合 CURRENT_USER が指定されている場合、プロシージャを実行している現行ユーザーの権限を使用してアクセス権限が決定されます。

パラレル{UNSAFE |制限された|安全 }

PARALLEL 句は、並列逐次走査（パラレルモード）の使用を可能にします。 並列逐次スキャンは、逐次逐次スキャンとは対照的に、クエリ中に複数のワーカーを使用してリレーションを並行してスキャンします。

UNSAFE に 設定すると 、パラレルモードでは実行できません。このようなプロシージャが存在すると、シリアル実行プランが強制されます。これは、 PARALLEL 句が省略された 場合のデフォルト設定です 。

RESTRICTED に 設定する と、プロシージャはパラレルモードで実行できますが、実行はパラレルグループリーダーに制限されます。特定の関係の資格に並行制限があるものがあれば、その関係は並列性のために選択されません。

SAFE に 設定されている場合 、プロシージャは制限なしでパラレルモードで実行できます。

COSTの 実行 _ コスト

実行 _ コストは、CPU _ オペレータ _ コスト の単位で手順の推定実行コストを与える正の数です 。プロシージャーがセットを戻す場合、これは戻された行あたりのコストです。値を大きくすると、プランナは必要以上に機能を評価しないようにします。

ROWSは _ 行の 結果

result _ rows は、プランナがプロシージャが返すと予想する行の推定数を示す正の数です。これは、プロシージャがセットを返すと宣言されている場合にのみ許可されます。デフォルトの仮定は1000行です。

SET 設定 _ パラメータ {TO 値 | = 値 | FROM CURRENT}

SET 句は、指定された設定パラメータは、手順が入力されると、指定された値に設定され、その前の値場合の処理手順が終了に復帰させます。 セット から CURRENT は、プロシージャーに入ったときに適用される値として、セッションの現行のパラメーター値を 保管 します。

場合 SET の SET 句は、プロシージャに装着され、その後、効果 同じ変数のプロシージャー内で実行される LOCAL コマンドは、プロシージャーに限定されています。プロシージャ出口で構成パラメータの事前値がリストアされます。 （LOCALなし ） 通常の SET コマンドは 、前の SET のために行うだろう限り、SET句を 上書きします 現在のトランザクションがロールバックされない限り、プロシージャの終了後にそのようなコマンドの効果が持続する LOCAL コマンド。

PRAGMA AUTONOMOUS_TRANSACTION

PRAGMA AUTONOMOUS_TRANSACTIONは、プロシージャを自律型トランザクションとして設定するディレクティブです。

注： STRICT 、 LEAKPROOF 、 PARALLEL 、 COST 、 ROWSおよびSETキーワードはAdvanced Serverの拡張機能を提供し、Oracleではサポートされていません。

注： IMMUTABLE、STABLE、STRICT、 漏れ防止 、 コスト 、ROWSおよびPARALLEL {UNSAFE |制限された| SAFE}属性は、EDB SPLプロシージャーでのみサポートされています。

注意：デフォルトでは、ストアドプロシージャはセキュリティディレクタとして作成されます。 plpgsqlで定義されたストアド・プロシージャは、 SECURITY INVOKERSとして作成されます。

例

次の手順では、 empテーブルの従業員を一覧表示します。

CREATE OR REPLACE PROCEDURE list_emp

IS

v_empno NUMBER(4);

v_ename VARCHAR2(10);

CURSOR emp_cur IS

SELECT empno, ename FROM emp ORDER BY empno;

BEGIN

OPEN emp_cur;

DBMS_OUTPUT.PUT_LINE('EMPNO ENAME');

DBMS_OUTPUT.PUT_LINE('----- -------');

LOOP

FETCH emp_cur INTO v_empno, v_ename;

EXIT WHEN emp_cur%NOTFOUND;

DBMS_OUTPUT.PUT_LINE(v_empno || ' ' || v_ename);

END LOOP;

CLOSE emp_cur;

END;

 

EXEC list_emp;

 

EMPNO ENAME

----- -------

7369 SMITH

7499 ALLEN

7521 WARD

7566 JONES

7654 MARTIN

7698 BLAKE

7782 CLARK

7788 SCOTT

7839 KING

7844 TURNER

7876 ADAMS

7900 JAMES

7902 FORD

7934 MILLER

次のプロシージャは、 IN OUTおよびOUT引数を使用して、最初に指定した従業員番号を使用した検索に基づいて従業員の番号、名前、およびジョブを戻し、見つからない場合は指定された名前を使用します。無名ブロックが手続きを呼び出します。

CREATE OR REPLACE PROCEDURE emp_job (

p_empno IN OUT emp.empno%TYPE,

p_ename IN OUT emp.ename%TYPE,

p_job OUT emp.job%TYPE

)

IS

v_empno emp.empno%TYPE;

v_ename emp.ename%TYPE;

v_job emp.job%TYPE;

BEGIN

SELECT ename, job INTO v_ename, v_job FROM emp WHERE empno = p_empno;

p_ename := v_ename;

p_job := v_job;

DBMS_OUTPUT.PUT_LINE('Found employee # ' || p_empno);

EXCEPTION

WHEN NO_DATA_FOUND THEN

BEGIN

SELECT empno, job INTO v_empno, v_job FROM emp

WHERE ename = p_ename;

p_empno := v_empno;

p_job := v_job;

DBMS_OUTPUT.PUT_LINE('Found employee ' || p_ename);

EXCEPTION

WHEN NO_DATA_FOUND THEN

DBMS_OUTPUT.PUT_LINE('Could not find an employee with ' ||

'number, ' || p_empno || ' nor name, ' || p_ename);

p_empno := NULL;

p_ename := NULL;

p_job := NULL;

END;

END;

 

DECLARE

v_empno emp.empno%TYPE;

v_ename emp.ename%TYPE;

v_job emp.job%TYPE;

BEGIN

v_empno := 0;

v_ename := 'CLARK';

emp_job(v_empno, v_ename, v_job);

DBMS_OUTPUT.PUT_LINE('Employee No: ' || v_empno);

DBMS_OUTPUT.PUT_LINE('Name : ' || v_ename);

DBMS_OUTPUT.PUT_LINE('Job : ' || v_job);

END;

 

Found employee CLARK

Employee No: 7782

Name : CLARK

Job : MANAGER

次の例は、プロシージャ宣言でAUTHID DEFINERおよびSET句を使用する方法を示しています。 更新 _ 給与の 手順は（手順の実行中）プロシージャを呼び出している役割に手順を定義したロールの権限を伝えます ：

CREATE OR REPLACE PROCEDURE update_salary(id INT, new_salary NUMBER)

SET SEARCH_PATH = 'public' SET WORK_MEM = '1MB'

AUTHID DEFINER IS

BEGIN

UPDATE emp SET salary = new_salary WHERE emp_id = id;

END;

プロシージャの検索パスを public に、ワークメモリを 1MB に設定するに は、 SET 句を 含めます 。他のプロシージャ、関数、およびオブジェクトは、これらの設定の影響を受けません。

この例では、 AUTHID DEFINER 句は、プロシージャ内の文の実行を許可されないロールに一時的に権限を付与します。プロシージャを呼び出すロールに関連付けられた権限を使用するようにサーバーに指示するには、 AUTHID AUTHIDを 持つ DEFINER 句 CURRENT _ USER 節。

関連項目

除外手順