sp_data_source_objects (Transact-SQL)

Articolo
08/21/2024

Si applica a: SQL Server 2019 (15.x)

restituisce un elenco di oggetti tabella disponibili per la virtualizzazione.

Sintassi

Convenzioni relative alla sintassi 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' ]
[ ; ]

Argomenti

[ @data_source = ] 'data_source'

Nome dell'origine dati esterna da cui ottenere i metadati. @data_source è sysname.

[ @object_root_name = ] 'object_root_name'

Questo parametro è la radice del nome degli oggetti da cercare. @object_root_name è nvarchar(max), con il impostazione predefinita NULL.

Questa chiamata restituisce solo oggetti esterni che iniziano con il valore impostato per @object_root_name.

Se un'origine dati ODBC si connette a un sistema di gestione di database relazionale (RDBMS) che usa nomi in tre parti, @object_root_name non può contenere un nome di database parziale. In questi casi, il parametro @object_root_name deve contenere tutte e tre le parti, con la terza parte che rappresenta il nome dell'oggetto da cercare.

Attenzione

A causa delle differenze tra piattaforme dati esterne, alcune piattaforme non restituiscono risultati se viene fornito il valore predefinito di NULL. Alcuni considerano NULL la mancanza di un filtro. Ad esempio, Oracle RDMBS non restituirà i risultati se NULL viene fornito per @object_root_name.

[ @max_search_depth = ] max_search_depth

Questo valore specifica la profondità massima (in parti) oltre il @object_root_name che si desidera cercare. @max_search_depth è un valore int con impostazione predefinita 1.

Ad esempio, un @max_search_depth di 1, con un @object_root_name che corrisponde al nome di un database di SQL Server, restituirà schemata contenuto all'interno del database.

Un @max_search_depth di NULL restituisce informazioni su @object_root_name se è esistente e non è vuoto, nel caso di catalogo o schema.

[ @search_options = ] 'search_options'

Il parametro search_options è nvarchar(max) con una impostazione predefinita di NULL.

Questo parametro non viene usato ma potrà essere implementato in futuro.

Set di risultati

Nome colonna	Tipo di dati	Descrizione
`OBJECT_TYPE`	nvarchar(200)	Tipo dell'oggetto (esempio: TABLE o DATABASE).
`OBJECT_NAME`	nvarchar(max)	Nome completo dell'oggetto . Carattere di escape con virgolette specifiche del back-end.
`OBJECT_LEAF_NAME`	nvarchar(max)	Nome dell'oggetto non qualificato.
`TABLE_LOCATION`	nvarchar(max)	Una stringa di posizione della tabella valida che può essere utilizzata per l'istruzione CREARE TABELLA ESTERNA. È `NULL` se non è applicabile.

Autorizzazioni

È necessaria l'autorizzazione ALTER ANY EXTERNAL DATA SOURCE.

Osservazioni:

L'istanza di SQL Server deve avere la funzionalità PolyBase installata. Questa procedura è stata introdotta per la prima volta in SQL Server 2019 CU5.

Questa stored procedure supporta i connettori per:

SQL Server
Oracle
Teradata
MongoDB
Azure Cosmos DB

La stored procedure non supporta connettori di origine dati ODBC o hadoop.

Il concetto di vuoto e non vuoto è correlato al comportamento del driver ODBC e della funzione SQLTables. Non vuoto indica che un oggetto contiene tabelle, non righe. Ad esempio, uno schema vuoto non contiene tabelle in SQL Server. Un database vuoto non contiene tabelle all'interno di Teradata.

I tipi di oggetto sono determinati dal driver ODBC dell'origine dati esterna. Ogni origine dati esterna determina cosa qualifica come tabella. Può includere oggetti database come funzioni in Teradata o sinonimi in Oracle. PolyBase non è in grado di connettersi ad alcuni oggetti ODBC come tabelle esterne e pertanto non avrà un valore nella colonna TABLE_LOCATION. Nonostante l'assenza di valori in TABLE_LOCATION, la presenza di uno di questi oggetti ODBC potrebbe rendere un database o uno schema non vuoto.

Usare sp_data_source_objects e sp_data_source_table_columns per individuare oggetti esterni. Queste stored procedure di sistema restituiscono lo schema delle tabelle disponibili per la virtualizzazione. Azure Data Studio usa queste due stored procedure per supportare la virtualizzazione dei dati. Usare sp_data_source_table_columns per individuare gli schemi di tabella esterni rappresentati nei tipi di dati di SQL Server.

Tabelle esterne per raccolte MongoDB che contengono matrici

Per creare tabelle esterne nelle raccolte MongoDB contenenti matrici, è necessario usare l'estensione di virtualizzazione dei dati per Azure Data Studio per produrre un'istruzione CREATE EXTERNAL TABLE basata sullo schema rilevato dal driver ODBC PolyBase per MongoDB. Le prestazioni di appiattimento vengono eseguite automaticamente dal driver. In alternativa, è possibile usare sp_data_source_objects per rilevare lo schema della raccolta (colonne) e creare manualmente la tabella esterna. La stored procedure sp_data_source_table_columns esegue inoltre l'appiattimento automatico tramite il driver ODBC di PolyBase per il driver MongoDB. L'estensione di virtualizzazione dei dati per Azure Data Studio e sp_data_source_table_columns usano le stesse stored procedure interne per eseguire query sullo schema esterno.

Osservazioni specifiche relative al tipo di origine dati

Teradata

Le visualizzazioni di sistema Teradata non usano la sicurezza a livello di riga e quindi gli utenti possono visualizzare l'esistenza di tabelle che non possono eseguire query.
MongoDB

Alcune versioni precedenti di MongoDB applicano restrizioni alla possibilità di elencare tutti i database agli utenti nel ruolo di amministratori. Gli utenti senza questa autorizzazione potrebbero ricevere errori di autenticazione durante il tentativo di eseguire questa procedura con un null @object_root_name.
Oracle

I sinonimi di Oracle non possono essere usati con PolyBase.

Esempi

SQL Server

Nell'esempio seguente vengono restituiti tutti i database, schemata e tabelle/visualizzazioni

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;

OBJECT_TYPE	OBJECT_NAME	OBJECT_LEAF_NAME	TABLE_LOCATION
`DATABASE`	`"database"`	`database`	`NULL`
`SCHEMA`	`"database"."dbo"`	`dbo`	`NULL`
`TABLE`	`"database"."dbo"."customer"`	`customer`	`[database].[dbo].[customer]`
`TABLE`	`"database"."dbo"."item"`	`item`	`[database].[dbo].[item]`
`TABLE`	`"database"."dbo"."nation"`	`nation`	`[database].[dbo].[nation]`

Nell'esempio seguente vengono restituiti tutti i database.

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

EXEC sp_data_source_objects @data_source, @object_root_name;

OBJECT_TYPE	OBJECT_NAME	OBJECT_LEAF_NAME	TABLE_LOCATION
`DATABASE`	`UserDatabase`	`UserDatabase`	`NULL`
`DATABASE`	`master`	`master`	`NULL`
`DATABASE`	`msdb`	`msdb`	`NULL`
`DATABASE`	`tempdb`	`tempdb`	`NULL`
`DATABASE`	`database`	`database`	`NULL`

Nell'esempio seguente vengono restituiti tutti gli schemi in un database.

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

EXEC sp_data_source_objects @data_source, @object_root_name;

OBJECT_TYPE	OBJECT_NAME	OBJECT_LEAF_NAME	TABLE_LOCATION
`SCHEMA`	`"database"."dbo"`	`dbo`	`NULL`
`SCHEMA`	`"database"."INFORMATION_SCHEMA"`	`INFORMATION_SCHEMA`	`NULL`
`SCHEMA`	`"database"."sys"`	`sys`	`NULL`

Nell'esempio seguente vengono restituite tutte le tabelle nello schema.

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;

OBJECT_TYPE	OBJECT_NAME	OBJECT_LEAF_NAME	TABLE_LOCATION
`TABLE`	`"database"."dbo"."customer"`	`customer`	`[database].[dbo].[customer]`
`TABLE`	`"database"."dbo"."item"`	`item`	`[database].[dbo].[item]`
`TABLE`	`"database"."dbo"."nation"`	`nation`	`[database].[dbo].[nation]`
`TABLE`	`"database"."dbo"."orders"`	`orders`	`[database].[dbo].[orders]`
`TABLE`	`"database"."dbo"."part"`	`part`	`[database].[dbo].[part]`

Oracle

Nell'esempio seguente vengono restituiti lo schema completo e le tabelle, le funzioni, le visualizzazioni e così via.

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;

OBJECT_TYPE	OBJECT_NAME	OBJECT_LEAF_NAME	TABLE_LOCATION
`VIEW`	`"SYS"."ALL_SQLSET_STATEMENTS"`	`ALL_SQLSET_STATEMENTS`	`[ORACLEOBJECTROOT].[SYS].[ALL_SQLSET_STATEMENTS]`
`SYSTEM TABLE`	`"SYS"."BOOTSTRAP$"`	`BOOTSTRAP$`	`[ORACLEOBJECTROOT].[SYS].[BOOTSTRAP$]`
`SYNONYM`	`"PUBLIC"."ALL_ALL_TABLES"`	`ALL_ALL_TABLES`	`NULL`
`SCHEMA`	`"database"`	`database`	`NULL`
`TABLE`	`"database"."customer"`	`customer`	`[ORACLEOBJECTROOT].[database].[customer]`

Teradata

Nell'esempio seguente vengono restituiti tutti i database, le funzioni, visualizzazioni, ecc.

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;

OBJECT_TYPE	OBJECT_NAME	OBJECT_LEAF_NAME	TABLE_LOCATION
`FUNCTION`	`"SYSLIB"."ExtractRoles"`	`ExtractRoles`	`NULL`
`SYSTEM TABLE`	`"DBC"."UDTCast"`	`UDTCast`	`[DBC].[UDTCast]`
`TYPE`	`"SYSUDTLIB"."XML"`	`XML`	`NULL`
`DATABASE`	`"database"`	`database`	`NULL`
`TABLE`	`"database"."customer"`	`customer`	`[database].[customer]`

MongoDB

Nell'esempio seguente vengono restituiti tutti i database e le tabelle.

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;

OBJECT_TYPE	OBJECT_NAME	OBJECT_LEAF_NAME	TABLE_LOCATION
`DATABASE`	`"database"`	`database`	`NULL`
`TABLE`	`"database"."customer"`	`customer`	`[database].[customer]`
`TABLE`	`"database"."item"`	`item`	`[database].[item]`
`TABLE`	`"database"."nation"`	`nation`	`[database].[nation]`
`TABLE`	`"database"."orders"`	`orders`	`[database].[orders]`

Condividi tramite

sp_data_source_objects (Transact-SQL)

Sintassi

Argomenti

[ @data_source = ] 'data_source'

[ @object_root_name = ] 'object_root_name'

[ @max_search_depth = ] max_search_depth

[ @search_options = ] 'search_options'

Set di risultati

Autorizzazioni

Osservazioni:

Tabelle esterne per raccolte MongoDB che contengono matrici

Osservazioni specifiche relative al tipo di origine dati

Esempi

SQL Server

Oracle

Teradata

MongoDB

Commenti e suggerimenti

Risorse aggiuntive

Condividi tramite

sp_data_source_objects (Transact-SQL)

Sintassi

Argomenti

[ @data_source = ] 'data_source'

[ @object_root_name = ] 'object_root_name'

[ @max_search_depth = ] max_search_depth

[ @search_options = ] 'search_options'

Set di risultati

Autorizzazioni

Osservazioni:

Tabelle esterne per raccolte MongoDB che contengono matrici

Osservazioni specifiche relative al tipo di origine dati

Esempi

SQL Server

Oracle

Teradata

MongoDB

Contenuto correlato

Commenti e suggerimenti

Risorse aggiuntive