CATALOG_VDP_METADATA_VIEWS¶
説明
ストアドプロシージャ CATALOG_VDP_METADATA_VIEWS
は、Virtual DataPort データベースのすべてのビューのすべてのフィールドに関する情報を返します。この情報には、フィールドの型、精度 (数値の場合) などが含まれます。
ビューとデータベースの一方または両方でフィルタできます。
構文
CATALOG_VDP_METADATA_VIEWS (
input_database_name : text
, input_view_name : text
)
input_database_name
: データベースの名前。input_view_name
: フィールドを取得するビューの名前。
このプロシージャは、各ビューのフィールドごとに 1 つの行を返します。
input_database_name
および input_view_name
が null
の場合、このプロシージャはすべてのデータベースのすべてのビューのフィールドを返します。
input_view_name
が null
の場合、このプロシージャは database
のすべてのビューのフィールドを返します。
出力スキーマには以下のフィールドがあります。
database_name
: フィールドのビューが属すデータベースの名前。view_name
: ビューのフィールドの名前。view_type
: ビューのタイプ。0
: 基本ビュー。1
: 派生ビュー。
column_name
: フィールドの名前。column_type_name
: フィールドの「ソース型プロパティ」内のフィールド型の名前。たとえば、VARCHAR
、NCHAR
、INTEGER
、BIGINT
などです。これらは、JDBC API のクラス java.sql.Types に定義されている定数の名前です。
column_type
: フィールドの「ソース型プロパティ」内のフィールドの型を表す数字。このフィールドの値は、JDBC API のクラス java.sql.Types に定義されています。たとえば、
INT
=4
、VARCHAR
=12
などです。column_type_precision
: この意味は、フィールドの型によって異なります。text
型のフィールドの場合、これはフィールドの最大長を示します。数値型の場合、これは精度を示します。このため、
int
およびlong
フィールドの場合、この数字は0
です。
column_type_length
: このフィールドの値の最大長 (バイト単位)。column_type_scale
: このフィールドの値が格納できる小数部の桁数。column_vdp_type_name
: Virtual DataPort の型の名前。この値は、フィールドの「ソース型プロパティ」に設定されている型を返す「column_type_name」とは異なります。column_description
: フィールドの説明。フィールドに説明が存在しない場合、この値は空の文字列です。column_vdp_type_database
: 列の型が複合型に定義されているデータベース。型がプリミティブ (「text」「long」など) の場合はnull
です。
必要な権限
このプロシージャは、ユーザーが Metadata 権限を持っているビューに関する情報のみを返します。その意味は以下のとおりです。
ユーザーが管理者の場合、このプロシージャはすべてのデータベースのすべてのビューに関する情報を返します。
このプロシージャは、ユーザーがローカル管理者であるデータベースのビューに関する情報を返します。
このプロシージャは、ユーザーが Connect 権限および Metadata 権限を持っているデータベースのビューに関する情報を返します。
このプロシージャは、「権限エラー」を返しません。たとえば、以下の例を考えてみます。
ユーザーが以下を実行します。
SELECT * FROM CATALOG_VDP_METADATA_VIEWS();
(すべてのデータベースのすべてのビューのすべてのフィールドに関する情報を取得)
このユーザーは、
testing
データベースに対する Connect 権限と Metadata 権限のみを持っています。
このシナリオでは、このプロシージャは testing
データベースのビューに関する情報のみを返し、他のデータベースのビューに関する情報は返しません。