NEXT_DATABASE(  database-id  )

INT

NEXT_DATABASE 関数を使用して、データベースサーバで実行中のデータベースを列挙できます。最初のデータベースを取得するには、NULL を渡指定します。その後の各データベースを取得するには、前回の戻り値を指定ます。データベースがなくなると、NULL を返します。データベース ID 番号は特定の順序で返されるわけではありませんが、データベース ID を使用して、サーバで開始されたデータベースの順序を知ることができます。サーバで最初に開始されたデータベースには値 0 が割り当てられ、サーバでその後に開始されたデータベースには、データベース ID が 1 ずつ増分されます。

「クラウドに関する注意：」テナントデータベース独立性ルールのため、この関数がクラウドで呼び出された場合、現在のテナントデータベースについての情報のみを返します。

この関数を実行して現在のデータベースを返す場合、権限は必要ありません。この関数を他のデータベースに対して実行するには、SERVER OPERATOR または MONITOR のシステム権限を持っていることが必要です。

• DB_NAME 関数 [システム]
• sa_db_list システムプロシージャ

次の文は、最初のデータベースの値である 0 を返します。

SELECT NEXT_DATABASE( NULL );

次の文は、1 つのデータベースが起動している場合のみ NULL を返します。

SELECT NEXT_DATABASE( 0 );