sp_data_source_objects (Transact-SQL)

適用対象: SQL Server 2019 (15.x)

仮想化可能なテーブル オブジェクトのリストを返します。

構文

Transact-SQL 構文表記規則

sp_data_source_objects
        [ @data_source = ] 'data_source'
    [ , [ @object_root_name = ] 'object_root_name' ]
    [ , [ @max_search_depth = ] max_search_depth ]
    [ , [ @search_options = ] 'search_options' ]
[ ; ]

引数

[ @data_source = ] 'data_source'

メタデータを取得する外部データ ソースの名前。 @data_source は sysname です。

[ @object_root_name = ] 'object_root_name'

このパラメーターは、検索するオブジェクトの名前のルートです。 @object_root_name は nvarchar(max) です。既定値は NULL です。

この呼び出しは、@object_root_name に設定された値で始まる外部オブジェクトのみを返します。

ODBC データ ソースが 3 部構成の名前を使用するリレーショナル データベース管理システム (RDBMS) に接続する場合、 @object_root_name データベース名の一部を含めることはできません。 このような場合、パラメーター @object_root_name には 3 つの部分をすべて含める必要があります。3 番目の部分は検索するオブジェクト名です。

[ @max_search_depth = ] max_search_depth

この値は、検索する @object_root_name を超える最大深度 (部分単位) を指定します。 @max_search_depth は既定値 1 の int です。

たとえば、 SQL Server データベースの名前である@object_root_name を持つ 1 の @max_search_depth は、データベース内に含まれる schemata を返します。

@max_search_depthは、カタログまたはスキーマの NULL 場合、@object_root_name が存在し、空でない場合に関する情報を返します。

[ @search_options = ] 'search_options'

パラメーター search_options は nvarchar(max) で、既定値は NULL です。

このパラメーターは使用されませんが、将来実装される可能性があります。

結果セット

アクセス許可

ALTER ANY EXTERNAL DATA SOURCE 権限が必須です。

解説

SQL Server インスタンスには、PolyBase 機能がインストールされている必要があります。 この手順は、SQL Server 2019 CU5 で初めて導入されました。

このストアド プロシージャでは、次のコネクタがサポートされています。

• SQL Server
• Oracle
• Teradata
• MongoDB
• Azure Cosmos DB

ストアド プロシージャは、汎用 ODBC データ ソースまたは Hadoop コネクタをサポートしていません。

空と空以外の概念は、ODBC ドライバーと SQLTables 関数の動作に関連します。 空でない場合は、オブジェクトに行ではなくテーブルが含まれていることを示します。 たとえば、空のスキーマには SQL Server にテーブルが含まれています。 空のデータベースには、Teradata 内にテーブルが含まれています。

オブジェクトの種類は、外部データ ソースの ODBC ドライバーによって決まります。 各外部データ ソースによって、テーブルとして適格なものが決まります。 これには、Teradata の関数などのデータベース オブジェクトや、Oracle のシノニムを含めることができます。 PolyBase は一部の ODBC オブジェクトに外部テーブルとして接続できないため、TABLE_LOCATION 列に値はありません。 TABLE_LOCATION に値がないにもかかわらず、これらの ODBC オブジェクトのいずれかが存在すると、データベースまたはスキーマが空でない場合があります。

外部オブジェクトを検出するために使用 sp_data_source_objects および sp_data_source_table_columns します。 これらのシステム ストアド プロシージャは、仮想化可能なテーブルのスキーマを返します。 Azure Data Studio では、これら 2 つのストアド プロシージャを使用してデータ仮想化をサポートします。 sp_data_source_table_columns を使用して、SQL Server データ型で表される外部テーブル スキーマを検出します。

配列を含む MongoDB コレクションの外部テーブル

配列を含む MongoDB コレクションに外部テーブルを作成するには、Azure Data Studio 用のデータ仮想化の拡張機能を使用して、MongoDB 用 PolyBase ODBC ドライバーによって検出されたスキーマに基づいて CREATE EXTERNAL TABLE ステートメントを生成する必要があります。 フラット化アクションは、ドライバーによって自動的に実行されます。 または、sp_data_source_objects を使用してコレクション スキーマ (列) を検出し、外部テーブルを手動で作成することもできます。 sp_data_source_table_columns ストアド プロシージャでは、MongoDB 用 PolyBase ODBC ドライバーによってフラット化も自動的に実行されます。 Azure Data Studio 用のデータ仮想化の拡張機能と sp_data_source_table_columns は同じ内部ストアド プロシージャを使用して、外部スキーマのクエリを実行します。

データ ソースの種類固有の注釈

• Teradata

  Teradata システム ビューでは行レベルセキュリティ (RLS) が使用されないため、ユーザーはクエリできないテーブルの存在を確認できます。

• MongoDB

  一部の以前のバージョンの MongoDB では、すべてのデータベースを管理者に似たユーザーに一覧表示する機能が制限されています。 このアクセス許可を持たないユーザーは、null 値 @object_root_nameでこのプロシージャを実行しようとすると認証エラーが発生する可能性があります。

• Oracle

  PolyBase での使用では、Oracle シノニムはサポートされていません。

例

SQL Server

次の例では、すべてのデータベース、schemata、およびテーブル/ビューが返されます

DECLARE @data_source SYSNAME = N'ExternalDataSourceName';
DECLARE @object_root_name NVARCHAR(MAX) = NULL;
DECLARE @max_search_depth INT = 3;

EXEC sp_data_source_objects @data_source,
    @object_root_name,
    @max_search_depth;

次の例では、すべてのデータベースを返します

DECLARE @data_source SYSNAME = N'ExternalDataSourceName';
DECLARE @object_root_name NVARCHAR(MAX) = NULL;

EXEC sp_data_source_objects @data_source, @object_root_name;

次の例は、データベースのすべてのスキーマを返します

DECLARE @data_source SYSNAME = N'ExternalDataSourceName';
DECLARE @object_root_name NVARCHAR(MAX) = N'[database]';

EXEC sp_data_source_objects @data_source, @object_root_name;

次の例は、スキーマのすべてのテーブルを返します

DECLARE @data_source SYSNAME = N'ExternalDataSourceName';
DECLARE @object_root_name NVARCHAR(MAX) = N'[database].[dbo]';

EXEC sp_data_source_objects @data_source, @object_root_name;

Oracle

次の例では、完全な schemata とテーブル、関数、ビューなどを返します。

DECLARE @data_source SYSNAME = N'ExternalDataSourceName';
DECLARE @object_root_name NVARCHAR(MAX) = N'[OracleObjectRoot]';
DECLARE @max_search_depth INT = 2;

EXEC sp_data_source_objects @data_source, @object_root_name, @max_search_depth;

Teradata

次の例では、すべてのデータベースとテーブル、関数、ビューなどを返します。

DECLARE @data_source SYSNAME = N'ExternalDataSourceName';
DECLARE @object_root_name NVARCHAR(MAX) = NULL;
DECLARE @max_search_depth INT = 2;

EXEC sp_data_source_objects @data_source, @object_root_name, @max_search_depth;

Mongo DB

次の例では、 すべてのデータベースとテーブルを返します

DECLARE @data_source SYSNAME = N'ExternalDataSourceName';
DECLARE @object_root_name NVARCHAR(MAX) = NULL;
DECLARE @max_search_depth INT = 2;

EXEC sp_data_source_objects @data_source, @object_root_name, @max_search_depth;

関連するコンテンツ

• sp_data_source_columns
• CREATE EXTERNAL TABLE AS SELECT (CETAS) (Transact-SQL)
• CREATE EXTERNAL TABLE (Transact-SQL)
• Azure Data Studio 用のデータ仮想化の拡張機能
• SQL Server の PolyBase を使用したデータ仮想化
• システム ストアド プロシージャ (Transact-SQL)