Discovery - Discover Catalogs

Tjeneste:

MirroredAzureDatabricksCatalog

API-versjon:

v1

Merk deg

Dette er en testversjon av API-en.

Returnerer en liste over kataloger fra Unity Catalog.
Denne API-en støtter paginering.

Tillatelser

Innringeren må ha visningsprogram eller høyere arbeidsområderolle.

Nødvendige delegerte omfang

Workspace.Read.All eller Workspace.ReadWrite.All eller DatabricksCatalog.Read.All

Microsoft Entra-støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identitet	Kundestøtte
Bruker	Ja
tjenestekontohaver og administrerte identiteter	Nei

Grensesnitt

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/azuredatabricks/catalogs?databricksWorkspaceConnectionId={databricksWorkspaceConnectionId}

Med valgfrie parametere:

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/azuredatabricks/catalogs?databricksWorkspaceConnectionId={databricksWorkspaceConnectionId}&continuationToken={continuationToken}&maxResults={maxResults}

URI-parametere

Navn	I	Obligatorisk	Type	Beskrivelse
workspaceId	path	True	string (uuid)	Arbeidsområde-ID-en.
databricksWorkspaceConnectionId	query	True	string (uuid)	Tilkoblings-ID for databricks-arbeidsområdet.
continuationToken	query		string	Et token for å hente neste side med resultater.
maxResults	query		integer	Maksimalt antall resultater som skal returneres.

Svar

Navn	Type	Beskrivelse
200 OK	DatabricksCatalogs	Forespørselen er fullført.
Other Status Codes	ErrorResponse	Vanlige feilkoder: OperationNotSupportedForItem – operasjonen støttes ikke for forespurt element. CorruptedPayload – den angitte nyttelasten er skadet.

Eksempler

List Databricks catalogs example

Eksempelforespørsel

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/azuredatabricks/catalogs?databricksWorkspaceConnectionId=c1128f28-d84f-417c-8234-0feb91e35f86

Eksempelsvar

Statuskode:

200

{
  "value": [
    {
      "name": "catalog_1",
      "catalogType": "MANAGED_CATALOG",
      "storageLocation": "abfss://default@externalaccount.dfs.core.windows.net/__unitystorage/catalogs/230217cd-94f2-4017-907d-768298b02e2b",
      "fullName": "catalog_1"
    },
    {
      "name": "catalog_2",
      "catalogType": "MANAGED_CATALOG",
      "storageLocation": "abfss://default@externalaccount.dfs.core.windows.net/__unitystorage/catalogs/230217cd-94f2-4017-907d-768298b02e2b",
      "fullName": "catalog_2"
    }
  ],
  "continuationToken": null,
  "continuationUri": null
}

Definisjoner

Navn	Beskrivelse
CatalogType	Katalogtypen. Flere CatalogType-typer kan legges til over tid.
DatabricksCatalog	En katalog fra Unity Catalog
DatabricksCatalogs	En liste over kataloger fra Unity Catalog.
ErrorRelatedResource	Objektet for feilrelaterte ressursdetaljer.
ErrorResponse	Feilsvaret.
ErrorResponseDetails	Feilsvardetaljene.

CatalogType

Opplisting

Katalogtypen. Flere CatalogType-typer kan legges til over tid.

Verdi	Beskrivelse
MANAGED_CATALOG	Administrert katalog

DatabricksCatalog

Object

En katalog fra Unity Catalog

Navn	Type	Beskrivelse
catalogType	CatalogType	Katalogtypen.
fullName	string	Det fullstendige navnet på katalogen. Denne variabelen avhenger av navn.
name	string	Navnet på katalogen.
storageLocation	string	Lagringsplasseringen for katalogen.

DatabricksCatalogs

Object

En liste over kataloger fra Unity Catalog.

Navn	Type	Beskrivelse
Error	ErrorResponse	Feilen angis hvis kataloger ikke kan hentes
continuationToken	string	Tokenet for den neste resultatsettgruppen. Hvis det ikke er flere poster, fjernes den fra svaret.
continuationUri	string	URI-en for neste satsvise resultatsett. Hvis det ikke er flere poster, fjernes den fra svaret.
value	DatabricksCatalog[]	En liste over kataloger.

ErrorRelatedResource

Object

Objektet for feilrelaterte ressursdetaljer.

Navn	Type	Beskrivelse
resourceId	string	Ressurs-ID-en som er involvert i feilen.
resourceType	string	Typen ressurs som er involvert i feilen.

ErrorResponse

Object

Feilsvaret.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
moreDetails	ErrorResponseDetails[]	Liste over flere feildetaljer.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.
requestId	string	ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Object

Feilsvardetaljene.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.