Megosztás a következőn keresztül:

Items - Create SQL Database

  • Referencia
Szolgáltatás:
SQLDatabase
API-verzió:
v1

Jegyzet

Ez az API előzetes verzióban érhető el.

Létrehoz egy SQL-adatbázist a megadott munkaterületen.
Ez az API támogatja hosszú ideig futó műveleteket (LRO).

Ez az API nem támogatja a definícióval rendelkező SQL-adatbázis létrehozását.

Engedélyek

A hívónak közreműködői vagy magasabb munkaterületi szerepkört kell tartalmaznia.

Kötelező delegált hatókörök

SQLDatabase.ReadWrite.All vagy Item.ReadWrite.All

Korlátozások

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Azonosság Támogat
Felhasználó Igen
szolgáltatásnév és felügyelt identitások Igen

Interfész

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/SQLDatabases

URI-paraméterek

Name In Kötelező Típus Description
workspaceId
 path True

string (uuid)

A munkaterület azonosítója.

Kérelem törzse

Name Kötelező Típus Description
displayName True

string

Az SQL-adatbázis megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.
description

string

Az SQL-adatbázis leírása. A maximális hossz 256 karakter.

Válaszok

Name Típus Description
201 Created

SQLDatabase

Sikeresen létrehozva
202 Accepted

A kérelem elfogadva, az SQL Database kiépítése folyamatban van.

Fejlécek

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Gyakori hibakódok:

  • InvalidItemType – Az elem típusa érvénytelen

  • ItemDisplayNameAlreadyInUse – Az elem megjelenítendő neve már használatban van.

  • CorruptedPayload – A megadott hasznos adatok sérültek.

  • WorkspaceItemsLimitExceeded – A munkaterület elemkorlátja túllépve.

Példák

Create a SQLDatabase example

Mintakérelem

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/SQLDatabases

{
  "displayName": "SQLDatabase 1",
  "description": "A SQLDatabase description."
}

Mintaválasz

Állapotkód:
201 
{
  "displayName": "SQLDatabase 1",
  "description": "A SQLDatabase description.",
  "type": "SQLDatabase",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Állapotkód:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Definíciók

Name Description
CreateSQLDatabaseRequest

SQL Database-kérelem hasznos adatainak létrehozása.
ErrorRelatedResource

A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse

A hibaválasz.
ErrorResponseDetails

A hibaválasz részletei.
ItemType

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.
SQLDatabase

SQL-adatbázis-objektum.

CreateSQLDatabaseRequest

Objektum

SQL Database-kérelem hasznos adatainak létrehozása.

Name Típus Description
description

string

Az SQL-adatbázis leírása. A maximális hossz 256 karakter.
displayName

string

Az SQL-adatbázis megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.

ErrorRelatedResource

Objektum

A hibával kapcsolatos erőforrás-részletek objektum.

Name Típus Description
resourceId

string

A hibában érintett erőforrás-azonosító.
resourceType

string

A hibában érintett erőforrás típusa.

ErrorResponse

Objektum

A hibaválasz.

Name Típus Description
errorCode

string

Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message

string

A hiba emberi olvasható ábrázolása.
moreDetails

ErrorResponseDetails[]

További hibaadatok listája.
relatedResource

ErrorRelatedResource

A hibával kapcsolatos erőforrásadatok.
requestId

string

A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

A hibaválasz részletei.

Name Típus Description
errorCode

string

Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message

string

A hiba emberi olvasható ábrázolása.
relatedResource

ErrorRelatedResource

A hibával kapcsolatos erőforrásadatok.

ItemType

Enumerálás

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.

Érték Description
CopyJob

Másolási feladat.
Dashboard

PowerBI-irányítópult.
DataPipeline

Egy adatfolyam.
Datamart

PowerBI datamart.
Environment

Egy környezet.
Eventhouse

Egy rendezvényház.
Eventstream

Eseménystream.
GraphQLApi

Api a GraphQL-elemhez.
KQLDashboard

KQL-irányítópult.
KQLDatabase

KQL-adatbázis.
KQLQueryset

KQL-lekérdezéskészlet.
Lakehouse

Egy tóház.
MLExperiment

Gépi tanulási kísérlet.
MLModel

Gépi tanulási modell.
MirroredDatabase

Tükrözött adatbázis.
MirroredWarehouse

Egy tükrözött raktár.
MountedDataFactory

A MountedDataFactory.
Notebook

Egy jegyzetfüzet.
PaginatedReport

Többoldalas PowerBI-jelentés.
Reflex

Egy reflex.
Report

PowerBI-jelentés.
SQLDatabase

A SQLDatabase.
SQLEndpoint

EGY SQL-végpont.
SemanticModel

PowerBI szemantikai modell.
SparkJobDefinition

Spark-feladat definíciója.
VariableLibrary

Egy VariableLibrary.
Warehouse

Egy raktár.

SQLDatabase

Objektum

SQL-adatbázis-objektum.

Name Típus Description
description

string

Az elem leírása.
displayName

string

Az elem megjelenítendő neve.
folderId

string (uuid)

A mappa azonosítója.
id

string (uuid)

Az elem azonosítója.
type

ItemType

Az elem típusa.
workspaceId

string (uuid)

A munkaterület azonosítója.