Definisjon av SQL-database

Denne artikkelen inneholder en oversikt over definisjonsstrukturen for SQL-databaseelementer.

Støttede formater

Støtte og sqlproj formater for SQL-databaseelementerdacpac. Hvis det ikke er angitt noe format, vil operasjoner som standard være dacpac.

Datanivåprogrampakke (dacpac)-del

Delen dacpac er en fil som inneholder databasemodellen, som inkluderer alle SQL-databaseobjekter som tabeller, visninger og lagrede prosedyrer. Filen dacpac brukes til å distribuere og behandle databaseskjemaet på en deklarativ måte, og beregner dynamisk endringene som kreves for å oppdatere databasen for å samsvare dacpac med modellen.

En dacpac-fil kan opprettes ved hjelp av SQL-prosjekter i Visual Studio Code, kommandolinjeverktøyet SqlPackage eller andre databaseutviklingsverktøy som støtter dacpac-formatet. Finn ut mer om SQL-prosjekter og oppretting dacpac av filer i SQL-prosjektdokumentasjonen eller SQL-databasen i Fabric-artikkelen om SqlPackage.

Definisjonsdeler for dacpac format

Denne tabellen viser dacpac SQL-databasedefinisjonsdelene.

Definisjonsdelbane type Kreves Description
sqldb.dacpac Programpakke for datalag (dacpac) true Dacpac-filen (databasemodell)
.platform PlatformDetails (JSON) false Beskriver vanlige detaljer om elementet

Eksempel på definisjonsnyttelast ved hjelp av dacpac-format

{
  "definition": {
    "parts": [
      {
        "path": "sqldb.dacpac",
        "payload": "<base64 encoded string>",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "<base64 encoded string>",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

SQL-databaseprosjekt (sqlproj)-del

Et SQL-databaseprosjekt er en lokal representasjon av SQL-objekter som utgjør skjemaet for én enkelt database, for eksempel tabeller, lagrede prosedyrer eller funksjoner. Et SQL-databaseprosjekt testes vanligvis lokalt ved å bygge det inn i en dacpac fil for å se etter feil før du distribuerer det til en måldatabase for SQL. Strukturen til et SQL-databaseprosjekt er avhengig av databaseobjektene, der SQL-databasen i Fabric som standard organiserer prosjektfilene etter skjema og objekttype. En tabell som er navngitt Table1 i dbo skjemaet, vil for eksempel representeres av en filbane dbo/Tables/Table1.sqlfor . Finn ut mer om SQL-prosjekter i dokumentasjonen for SQL-prosjekter.

Definisjonsdeler for sqlproj format

Denne tabellen viser sqlproj SQL-databasedefinisjonsdelene.

Definisjonsdelbane type Kreves Description
sqldb.sqlproj SQL-databaseprosjekt true Er .sqlproj prosjektfilen for et Microsoft.Build.Sql-prosjekt. Den bygges til en dacpac fil og distribueres til måldatabasen for SQL. Bare én SQL-prosjektfil (.sqlproj) godtas per definisjon.
**/*.sql Sql-fil (Structured Query Language) false Én eller flere SQL-objektdefinisjonsfiler. Alle filer som ikke er eksplisitt utelatt av .sqlproj filen, er inkludert.
.sharedqueries/*.sql Sql-fil (Structured Query Language) false Én eller flere SQL-spørringsfiler. Disse spørringene distribueres til databasen som delte spørringer og er tilgjengelige i redigeringsprogrammet. Mappen .sharedqueries er utelatt fra SQL-prosjektfilen, og disse spørringene er ikke inkludert i byggprosessen.
.platform PlatformDetails (JSON) false Beskriver vanlige detaljer om elementet

Eksempel på definisjonsnyttelast ved hjelp av sqlproj-format

{
  "definition": {
    "parts": [
      {
        "path": "sqldb.sqlproj",
        "payload": "<base64 encoded string>",
        "payloadType": "InlineBase64"
      },
      {
        "path": "dbo/Tables/Table1.sql",
        "payload": "<base64 encoded string>",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".sharedqueries/query.sql",
        "payload": "<base64 encoded string>",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "<base64 encoded string>",
        "payloadType": "InlineBase64"
      }
    ]
  }
}