Items - Get SQL Database
Returnerer egenskapene for den angitte SQL-databasen.
Permissions
Innringeren må ha lesetillatelser for SQL-databasen.
Nødvendige delegerte omfang
SQLDatabase.Read.All eller SQLDatabase.ReadWrite.All eller Item.Read.All eller Item.ReadWrite.All
Microsoft Entra støttede identiteter
Denne API-en støtter Microsoft identiteter oppført i denne delen.
| Identity | Support |
|---|---|
| User | Yes |
| Tjenestekontohaver og administrerte identiteter | Yes |
Interface
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlDatabases/{sqlDatabaseId}
URI-parametere
| Name | I | Obligatorisk | Type | Beskrivelse |
|---|---|---|---|---|
|
sql
|
path | True |
string (uuid) |
SQL-database-ID-en. |
|
workspace
|
path | True |
string (uuid) |
Arbeidsområde-ID-en. |
Svar
| Name | Type | Beskrivelse |
|---|---|---|
| 200 OK |
Forespørselen er fullført. |
|
| 429 Too Many Requests |
Grensen for tjenestesats ble overskredet. Serveren returnerer en Overskrifter Retry-After: integer |
|
| Other Status Codes |
Vanlige feilkoder:
|
Eksempler
Get a SQLDatabase example
Eksempelforespørsel
GET https://api.fabric.microsoft.com/v1/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/sqlDatabases/41ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87
Eksempelsvar
{
"id": "5b218778-e7a5-4d73-8187-f10824047715",
"displayName": "SQLDatabase1",
"description": "A SQLDatabase description.",
"type": "SQLDatabase",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"properties": {
"connectionString": "Data Source=fvzeldvqgvce3b2hxvbg4hnjqu-nowrtjcsie2e3ny6v4ojbd3esa.database.fabric.microsoft.com,1433;Initial Catalog=SQLDatabase1-45c6e7cf-89b1-4a69-b4e1-5495271c7e45;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False",
"databaseName": "SQLDatabase1-45c6e7cf-89b1-4a69-b4e1-5495271c7e45",
"serverFqdn": "fvzeldvqgvce3b2hxvbg4hnjqu-nowrtjcsie2e3ny6v4ojbd3esa.database.fabric.microsoft.com,1433",
"earliestRestorePoint": "2024-12-01T00:00:00.000Z",
"latestRestorePoint": "2024-12-02T00:00:00.000Z",
"backupRetentionDays": 7,
"collation": "Albanian_CI_AI_WS"
},
"sensitivityLabel": {
"id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
}
}
Definisjoner
| Name | Beskrivelse |
|---|---|
|
Entire |
Representerer en leierkontohaver |
|
Error |
En strukturert parameter som gir ekstra maskinlesbar kontekst om en feil. |
|
Error |
Objektet for feilrelaterte ressursdetaljer. |
|
Error |
Feilsvaret. |
|
Error |
Feilsvardetaljene. |
|
Group |
Grupper bestemte detaljer. Gjelder når hovedtypen er |
|
Group |
Representerer en sikkerhetsgruppe. |
|
Group |
Typen gruppe. Flere gruppetyper kan legges til over tid. |
|
Item |
Representerer en kode som brukes på et element. |
|
Item |
Typen element. Flere elementtyper kan legges til over tid. |
|
Principal |
Typen hovedstol. Flere hovedstoltyper kan legges til over tid. |
|
Sensitivity |
Representerer en følsomhetsetikett som brukes på et element. |
|
Service |
Spesifikke detaljer for tjenestekontohaver. Gjelder når hovedtypen er |
|
Service |
Representerer en Microsoft Entra tjenestekontohaver. |
|
Service |
Detaljer for tjenestekontohaverprofil. Gjelder når hovedtypen er |
|
Service |
Representerer en tjenestekontohaverprofil. |
| SQLDatabase |
Et SQL-databaseobjekt. |
|
SQLDatabase |
Egenskapene for SQL-databasen. |
|
User |
Spesifikke detaljer for brukerkontohaver. Gjelder når hovedtypen er |
|
User |
Representerer en Microsoft Entra brukerkontohaver. |
EntireTenantPrincipal
Representerer en leierkontohaver
| Name | Type | Beskrivelse |
|---|---|---|
| displayName |
string |
Hovedkontohaverens visningsnavn. |
| id |
string (uuid) |
Hovedkontohaverens ID. |
| type |
string:
Entire |
Typen hovedstol. Flere hovedstoltyper kan legges til over tid. |
ErrorParameter
En strukturert parameter som gir ekstra maskinlesbar kontekst om en feil.
| Name | Type | Beskrivelse |
|---|---|---|
| message |
string |
En lesbar beskrivelse av parameterens betydning. |
| name |
string |
Parameteridentifikatoren. |
| value |
string |
Parameterverdien. |
ErrorRelatedResource
Objektet for feilrelaterte ressursdetaljer.
| Name | Type | Beskrivelse |
|---|---|---|
| resourceId |
string |
Ressurs-ID-en som er involvert i feilen. |
| resourceType |
string |
Typen ressurs som er involvert i feilen. |
ErrorResponse
Feilsvaret.
| Name | Type | Beskrivelse |
|---|---|---|
| errorCode |
string |
En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne. |
| isRetriable |
boolean |
Når sann, kan forespørselen prøves på nytt.
|
| message |
string |
En menneskelig lesbar representasjon av feilen. |
| moreDetails |
Liste over flere feildetaljer. |
|
| parameters |
Strukturerte parametere som gir ekstra maskinlesbar kontekst om feilen. |
|
| relatedResource |
Feilrelaterte ressursdetaljer. |
|
| requestId |
string (uuid) |
ID for forespørselen som er knyttet til feilen. |
ErrorResponseDetails
Feilsvardetaljene.
| Name | 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. |
| parameters |
Strukturerte parametere som gir ekstra maskinlesbar kontekst om feilen. |
|
| relatedResource |
Feilrelaterte ressursdetaljer. |
GroupDetails
Grupper bestemte detaljer. Gjelder når hovedtypen er Group.
| Name | Type | Beskrivelse |
|---|---|---|
| groupType |
Typen gruppe. Flere gruppetyper kan legges til over tid. |
GroupPrincipal
Representerer en sikkerhetsgruppe.
| Name | Type | Beskrivelse |
|---|---|---|
| displayName |
string |
Hovedkontohaverens visningsnavn. |
| groupDetails |
Grupper bestemte detaljer. Gjelder når hovedtypen er |
|
| id |
string (uuid) |
Hovedkontohaverens ID. |
| type |
string:
Group |
Typen hovedstol. Flere hovedstoltyper kan legges til over tid. |
GroupType
Typen gruppe. Flere gruppetyper kan legges til over tid.
| Verdi | Beskrivelse |
|---|---|
| Unknown |
Hovedgruppetypen er ukjent. |
| SecurityGroup |
Hovedstol er en sikkerhetsgruppe. |
| DistributionList |
Hovedstol er en distribusjonsliste. |
ItemTag
Representerer en kode som brukes på et element.
| Name | Type | Beskrivelse |
|---|---|---|
| displayName |
string |
Navnet på koden. |
| id |
string (uuid) |
Kode-ID-en. |
ItemType
Typen element. Flere elementtyper kan legges til over tid.
| Verdi | Beskrivelse |
|---|---|
| Dashboard |
PowerBI-instrumentbord. |
| Report |
PowerBI-rapport. |
| SemanticModel |
Semantisk PowerBI-modell. |
| PaginatedReport |
Paginert powerbi-rapport. |
| Datamart |
PowerBI-datamart. |
| Lakehouse |
Et innsjøhus. |
| Eventhouse |
Et arrangementshus. |
| Environment |
Et miljø. |
| KQLDatabase |
En KQL-database. |
| KQLQueryset |
Et KQL-spørringssett. |
| KQLDashboard |
Et KQL-instrumentbord. |
| DataPipeline |
Et datasamlebånd. |
| Notebook |
En notatblokk. |
| SparkJobDefinition |
En spark-jobbdefinisjon. |
| MLExperiment |
Et maskinlæringseksperiment. |
| MLModel |
En maskinlæringsmodell. |
| Warehouse |
Et lager. |
| Eventstream |
En hendelsesstrøm. |
| SQLEndpoint |
Et SQL-endepunkt. |
| MirroredWarehouse |
Et speilvendt lager. |
| MirroredDatabase |
En speilvendt database. |
| Reflex |
En refleks. |
| GraphQLApi |
En API for GraphQL-element. |
| MountedDataFactory |
En MountedDataFactory. |
| SQLDatabase |
En SQLDatabase. |
| CopyJob |
En kopieringsjobb. |
| VariableLibrary |
En VariableLibrary. |
| Dataflow |
En dataflyt. |
| ApacheAirflowJob |
En ApacheAirflowJob. |
| WarehouseSnapshot |
Et øyeblikksbilde av lageret. |
| DigitalTwinBuilder |
En DigitalTwinBuilder. |
| DigitalTwinBuilderFlow |
En digital Twin Builder-flyt. |
| MirroredAzureDatabricksCatalog |
En speilet azure databricks-katalog. |
| Map |
Et kart. |
| AnomalyDetector |
En avviksdetektor. |
| UserDataFunction |
En brukerdatafunksjon. |
| GraphModel |
En GraphModel. |
| GraphQuerySet |
Et graph QuerySet. |
| SnowflakeDatabase |
En Snowflake Database for å lagre Iceberg-tabeller opprettet fra Snowflake-kontoen. |
| OperationsAgent |
En OperationsAgent. |
| CosmosDBDatabase |
En Cosmos DB-database. |
| Ontology |
En ontologi. |
| EventSchemaSet |
En EventSchemaset. |
| DataAgent |
En DataAgent. |
| MirroredCatalog |
En MirroredCatalog. |
| PolicySet |
Et policysett. |
| AppBackend |
En AppBackend. |
| OrgApp |
En organisasjonsapp. |
| OrgAppAudience |
En organisasjonsapp målgruppe. |
| DataBuildToolJob |
En DataBuildToolJob. |
| AzureDatabricksStorage |
Et OneLake-støttet lagringselement for Azure Databricks. |
| Plan |
En plan. |
| Monitoring |
Et overvåkingselement. |
| DeploymentPlan |
En distribusjonsplan. |
| ShareSubscription |
Et delabonnement. |
| Share |
En del. |
| Playbook |
En strategiplan. |
| MirroredOneLake |
Et speilvendt OneLake-element. |
| PostgreSQLDatabase |
Et PostgreSQL-databaseelement i Microsoft Fabric. |
| CustomStreamConnector |
Et egendefinert Stream Connector-element i Microsoft Fabric. |
PrincipalType
Typen hovedstol. Flere hovedstoltyper kan legges til over tid.
| Verdi | Beskrivelse |
|---|---|
| User |
Hovedstol er en Microsoft Entra brukerkontohaver. |
| ServicePrincipal |
Principal er en Microsoft Entra tjenestekontohaver. |
| Group |
Hovedstol er en sikkerhetsgruppe. |
| ServicePrincipalProfile |
Principal er en tjenestekontohaverprofil. |
| EntireTenant |
Hovedstol representerer alle leierbrukere. |
SensitivityLabel
Representerer en følsomhetsetikett som brukes på et element.
| Name | Type | Beskrivelse |
|---|---|---|
| id |
string (uuid) |
Følsomhetsetikett-ID-en. |
ServicePrincipalDetails
Spesifikke detaljer for tjenestekontohaver. Gjelder når hovedtypen er ServicePrincipal.
| Name | Type | Beskrivelse |
|---|---|---|
| aadAppId |
string (uuid) |
Tjenestekontohaverens Microsoft Entra AppId. |
ServicePrincipalPrincipal
Representerer en Microsoft Entra tjenestekontohaver.
| Name | Type | Beskrivelse |
|---|---|---|
| displayName |
string |
Hovedkontohaverens visningsnavn. |
| id |
string (uuid) |
Hovedkontohaverens ID. |
| servicePrincipalDetails |
Spesifikke detaljer for tjenestekontohaver. Gjelder når hovedtypen er |
|
| type |
string:
Service |
Typen hovedstol. Flere hovedstoltyper kan legges til over tid. |
ServicePrincipalProfileDetails
Detaljer for tjenestekontohaverprofil. Gjelder når hovedtypen er ServicePrincipalProfile.
| Name | Type | Beskrivelse |
|---|---|---|
| parentPrincipal | Principal: |
Overordnet hovedkontohaver for tjenestekontohaverprofilen. |
ServicePrincipalProfilePrincipal
Representerer en tjenestekontohaverprofil.
| Name | Type | Beskrivelse |
|---|---|---|
| displayName |
string |
Hovedkontohaverens visningsnavn. |
| id |
string (uuid) |
Hovedkontohaverens ID. |
| servicePrincipalProfileDetails |
Detaljer for tjenestekontohaverprofil. Gjelder når hovedtypen er |
|
| type |
string:
Service |
Typen hovedstol. Flere hovedstoltyper kan legges til over tid. |
SQLDatabase
Et SQL-databaseobjekt.
| Name | Type | Beskrivelse |
|---|---|---|
| defaultIdentity | Principal: |
Elementets standardidentitet. |
| description |
string |
Elementbeskrivelsen. |
| displayName |
string |
Visningsnavnet for elementet. |
| folderId |
string (uuid) |
Mappe-ID-en. |
| id |
string (uuid) |
Element-ID-en. |
| logicalId |
string (uuid) |
Elementets logiske identifikator. Tilsvarende elementforekomster deler samme logiske ID. Verdien er null når ingen logisk ID er tilordnet. |
| properties |
SQLDatabase-egenskapene. |
|
| sensitivityLabel |
Elementfølsomhetsetiketten. |
|
| tags |
Item |
Liste over brukte merker. |
| type |
Elementtypen. |
|
| workspaceId |
string (uuid) |
Arbeidsområde-ID-en. |
SQLDatabaseProperties
Egenskapene for SQL-databasen.
| Name | Type | Beskrivelse |
|---|---|---|
| backupRetentionDays |
integer (int32) |
Oppbevaringsperioden for sikkerhetskopien i dager. |
| collation |
string |
Sorteringen av SQL-databasen. |
| connectionString |
string |
Databasens tilkoblingsstreng. |
| databaseName |
string |
Databasenavnet. |
| earliestRestorePoint |
string (date-time) |
ISO 8601-tidsstempelet for det tidligste gjenopprettingspunktet for databasen i UTC ved hjelp av YYYY-MM-DDTHH:mm:ssZ-formatet. |
| latestRestorePoint |
string (date-time) |
ISO 8601-tidsstempel for det nyeste gjenopprettingspunktet for databasen i UTC ved hjelp av formatet YYYY-MM-DDTHH:mm:ssZ. |
| serverFqdn |
string |
Serverens fullstendige domenenavn (FQDN). |
UserDetails
Spesifikke detaljer for brukerkontohaver. Gjelder når hovedtypen er User.
| Name | Type | Beskrivelse |
|---|---|---|
| userPrincipalName |
string |
Brukerhovednavn. |
UserPrincipal
Representerer en Microsoft Entra brukerkontohaver.
| Name | Type | Beskrivelse |
|---|---|---|
| displayName |
string |
Hovedkontohaverens visningsnavn. |
| id |
string (uuid) |
Hovedkontohaverens ID. |
| type |
string:
User |
Typen hovedstol. Flere hovedstoltyper kan legges til over tid. |
| userDetails |
Spesifikke detaljer for brukerkontohaver. Gjelder når hovedtypen er |