Catalog - Search

Servizio:: Core

Versione API:: v1

L'API Ricerca catalogo consente l'individuazione a livello di codice delle voci del catalogo OneLake tra aree di lavoro. Supporta la ricerca tra aree di lavoro sui metadati del catalogo e restituisce i risultati filtrati per le voci a cui l'entità chiamante è autorizzata ad accedere. I risultati della ricerca includono identificatori stabili che devono essere usati con api di Infrastruttura complementari per recuperare dettagli aggiuntivi o eseguire azioni supportate.

Annotazioni

La ricerca del catalogo è attualmente disponibile in anteprima (altre informazioni).

CatalogEntry è una rappresentazione di metadati individuabile di un'entità di Microsoft Fabric, attualmente con ambito per gli elementi dell'area di lavoro. Le voci del catalogo sono destinate solo all'individuazione dei metadati e non concedono l'accesso ai dati o al contenuto dell'elemento sottostante.

Ambiti delegati obbligatori

Catalog.Read.All

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Identità	Support
User	Sì
Principale del servizio e Identità gestite	Sì

Limitazioni

La funzionalità di ricerca ha attualmente come ambito tipi di elementi di Fabric specifici. I tipi di elemento seguenti non sono supportati: Dashboard, Dataflow (Gen1), Dataflow (Gen2).

Interfaccia

POST https://api.fabric.microsoft.com/v1/catalog/search

Corpo della richiesta

Nome	Tipo	Descrizione
continuationToken	string	ContinuationToken per la pagina successiva.
filter	string	Filtro per la ricerca. Attualmente il filtro supporta il filtro in base al tipo di voci. È possibile aggiungere altre opzioni di filtro nel tempo. Il parametro filter supporta gli operatori seguenti per perfezionare i risultati: eq : Equals; corrisponde al valore esatto. ne : diverso da; esclude il valore specificato. o : OR logico; corrisponde se una delle condizioni è vera. ( ) : parentesi; raggruppa le espressioni per definire la gerarchia logica.
pageSize	integer	Dimensioni della pagina che devono essere restituite. Le dimensioni della pagina devono essere comprese tra 1 e 1000.
search	string	Query di testo per la ricerca. Questo campo supporta la ricerca tra il nome visualizzato, il nome visualizzato dell'area di lavoro e la descrizione di CatalogEntry.

Risposte

Nome Tipo Descrizione

200 OK

Nome	Tipo	Descrizione
200 OK	CatalogQueryResponse	Va bene
429 Too Many Requests	ErrorResponse	È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione `Retry-After` che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive. Intestazioni Retry-After: integer
Other Status Codes	ErrorResponse	Codici di errore comuni: Non autorizzato - Autenticazione mancante o non valida Errore interno del server - Errore imprevisto del servizio.

CatalogQueryResponse

Va bene

429 Too Many Requests

ErrorResponse

È stato superato il limite di velocità del servizio. Il server restituisce un'intestazione Retry-After che indica, in secondi, per quanto tempo il client deve attendere prima di inviare richieste aggiuntive.

Intestazioni

Retry-After: integer

Other Status Codes

ErrorResponse

Codici di errore comuni:

Non autorizzato - Autenticazione mancante o non valida
Errore interno del server - Errore imprevisto del servizio.

Esempio

Search example

Esempio di richiesta

HTTP

POST https://api.fabric.microsoft.com/v1/catalog/search

{
  "search": "Sales Revenue",
  "pageSize": 2,
  "filter": "Type eq 'Report' or Type eq 'Lakehouse'"
}

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "id": "0acd697c-1550-43cd-b998-91bfb12347c6",
      "type": "Report",
      "catalogEntryType": "FabricItem",
      "displayName": "Monthly Sales Revenue",
      "description": "Consolidated revenue report for the current fiscal year.",
      "hierarchy": {
        "workspace": {
          "id": "7f2c8a91-3b4d-4e5f-a6b7-c8d9e0f1a2b3",
          "displayName": "Sales Analytics"
        }
      }
    },
    {
      "id": "5e8f2a1b-9c3d-4e7f-b6a5-d4c3b2a1e0f9",
      "type": "Lakehouse",
      "catalogEntryType": "FabricItem",
      "displayName": "Sales Revenue Lakehouse",
      "description": "Central lakehouse for sales transaction data.",
      "hierarchy": {
        "workspace": {
          "id": "a2b3c4d5-e6f7-4a8b-9c0d-1e2f3a4b5c6d",
          "displayName": "Finance Platform"
        }
      }
    }
  ],
  "continuationToken": "eyJza2lwIjoyLCJ0YWtl..."
}

Definizioni

Nome	Descrizione
CatalogEntryType	Tipo di voce del catalogo. È possibile aggiungere altri tipi di `CatalogEntryType` nel tempo.
CatalogQueryRequest	Query per la ricerca.
CatalogQueryResponse	Risultati della ricerca.
CatalogWorkspace	Area di lavoro per la voce del catalogo.
ErrorRelatedResource	Oggetto dei dettagli della risorsa relativo all'errore.
ErrorResponse	Risposta di errore.
ErrorResponseDetails	Dettagli della risposta di errore.
ItemCatalogEntry	Tipo di elemento fabric della voce del catalogo.
ItemCatalogEntryHierarchy	Predecessori immediati dell'elemento nell'architettura dei dati di Fabric. Vengono restituiti solo i livelli applicabili.
ItemType	Tipo dell'elemento. È possibile aggiungere altri tipi di elemento nel tempo.

CatalogEntryType

Enumerazione

Tipo di voce del catalogo. È possibile aggiungere altri tipi di CatalogEntryType nel tempo.

Valore	Descrizione
FabricItem	Tipo di voce del catalogo di elementi di Fabric.

CatalogQueryRequest

Oggetto

Query per la ricerca.

Nome	Tipo	Descrizione
continuationToken	string	ContinuationToken per la pagina successiva.
filter	string	Filtro per la ricerca. Attualmente il filtro supporta il filtro in base al tipo di voci. È possibile aggiungere altre opzioni di filtro nel tempo. Il parametro filter supporta gli operatori seguenti per perfezionare i risultati: eq : Equals; corrisponde al valore esatto. ne : diverso da; esclude il valore specificato. o : OR logico; corrisponde se una delle condizioni è vera. ( ) : parentesi; raggruppa le espressioni per definire la gerarchia logica.
pageSize	integer	Dimensioni della pagina che devono essere restituite. Le dimensioni della pagina devono essere comprese tra 1 e 1000.
search	string	Query di testo per la ricerca. Questo campo supporta la ricerca tra il nome visualizzato, il nome visualizzato dell'area di lavoro e la descrizione di CatalogEntry.

CatalogQueryResponse

Oggetto

Risultati della ricerca.

Nome	Tipo	Descrizione
continuationToken	string	ContinuationToken per la pagina successiva.
value	CatalogEntry[]: ItemCatalogEntry[]	Elenco di voci del catalogo

CatalogWorkspace

Oggetto

Area di lavoro per la voce del catalogo.

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato dell'area di lavoro.
id	string (uuid)	ID dell'area di lavoro.

ErrorRelatedResource

Oggetto

Oggetto dei dettagli della risorsa relativo all'errore.

Nome	Tipo	Descrizione
resourceId	string	ID risorsa coinvolto nell'errore.
resourceType	string	Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Oggetto

Risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
moreDetails	ErrorResponseDetails[]	Elenco di dettagli aggiuntivi sull'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.
requestId	string (uuid)	ID della richiesta associata all'errore.

ErrorResponseDetails

Oggetto

Dettagli della risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.

ItemCatalogEntry

Oggetto

Tipo di elemento fabric della voce del catalogo.

Nome	Tipo	Descrizione
catalogEntryType	string: FabricItem	Tipo di voce del catalogo.
description	string	Descrizione della voce del catalogo.
displayName	string	Nome visualizzato della voce del catalogo.
hierarchy	ItemCatalogEntryHierarchy	Gerarchia della voce del catalogo.
id	string (uuid)	ObjectId della voce del catalogo.
type	ItemType	Tipo di elemento Fabric.

ItemCatalogEntryHierarchy

Oggetto

Predecessori immediati dell'elemento nell'architettura dei dati di Fabric. Vengono restituiti solo i livelli applicabili.

Nome	Tipo	Descrizione
workspace	CatalogWorkspace	Area di lavoro che contiene l'elemento.

ItemType

Enumerazione

Tipo dell'elemento. È possibile aggiungere altri tipi di elemento nel tempo.

Valore	Descrizione
Dashboard	Dashboard di Power BI.
Report	Report di Power BI.
SemanticModel	Modello semantico di PowerBI.
PaginatedReport	Report impaginato di Power BI.
Datamart	Datamart di PowerBI.
Lakehouse	Una lakehouse.
Eventhouse	Una casa eventi.
Environment	Un ambiente.
KQLDatabase	Un database KQL.
KQLQueryset	Set di query KQL.
KQLDashboard	Dashboard KQL.
DataPipeline	Una pipeline di dati.
Notebook	Un notebook.
SparkJobDefinition	Definizione di processo Spark.
MLExperiment	Esperimento di Machine Learning.
MLModel	Modello di Machine Learning.
Warehouse	Un magazzino.
Eventstream	Flusso di eventi.
SQLEndpoint	Endpoint SQL.
MirroredWarehouse	Magazzino con mirroring.
MirroredDatabase	Database con mirroring.
Reflex	Un riflesso.
GraphQLApi	API per l'elemento GraphQL.
MountedDataFactory	Oggetto MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Processo di copia.
VariableLibrary	VariabileLibrary.
Dataflow	Flusso di dati.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Uno snapshot del warehouse.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Flusso di Generatore di gemelli digitali.
MirroredAzureDatabricksCatalog	Catalogo di Azure databricks con mirroring.
Map	Una mappa.
AnomalyDetector	Rilevamento anomalie.
UserDataFunction	Funzione dati utente.
GraphModel	A GraphModel.
GraphQuerySet	Oggetto Graph QuerySet.
SnowflakeDatabase	Un database Snowflake per archiviare le tabelle Iceberg create dall'account Snowflake.
OperationsAgent	Oggetto OperationsAgent.
CosmosDBDatabase	Un database Cosmos DB.
Ontology	Ontologia.
EventSchemaSet	An EventSchemaSet.
DataAgent	Oggetto DataAgent.
MirroredCatalog	Oggetto MirroredCatalog.