SQL-tietokannan määritelmä

Tässä artikkelissa on erittely SQL-tietokantakohteiden määritysrakenteesta.

Tuettu muodot

SQL-tietokantakohteiden tuki dacpac ja sqlproj muodot. Jos muotoa ei ole määritetty, toimintojen oletusarvo on dacpac.

Tietotason sovelluspaketin (dacpac) osa

Osa dacpac on tiedosto, joka sisältää tietokantamallin, joka sisältää kaikki SQL-tietokannan objektit, kuten taulukot, näkymät ja tallennetut toimintosarjat. Tiedostoa dacpac käytetään tietokannan rakenteen käyttöönottoon ja hallintaan deklaratiivisella tavalla, laskemalla dynaamisesti muutokset, joita tarvitaan tietokannan päivittämiseen mallin vastaamiseksi dacpac .

dacpac-tiedosto voidaan luoda käyttämällä SQL-projekteja Visual Studio Code, SqlPackage-komentorivityökalua tai muita tietokannan kehitystyökaluja, jotka tukevat dacpac-muotoa. Lisätietoja SQL-projekteista ja tiedostojen luomisesta dacpac on SQL-projektien dokumentaatiossa tai SqlPackage-artikkelin SQL-tietokannassa.

Muotoilun dacpac määritysosat

Tässä taulukossa on luettelo SQL-tietokannan dacpac määritysosista.

Määritysosan polku tyyppi Pakollinen Description
sqldb.dacpac Tietotason sovelluspaketti (dacpac) true Dacpac (tietokantamalli) -tiedosto
.platform PlatformDetails (JSON) false Kuvaa kohteen yleisiä tietoja

Määritysten hyötykuorman esimerkki dacpac-muotoa käyttämällä

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

SQL-tietokantaprojektin (sqlproj) osa

SQL-tietokantaprojekti on SQL-objektien paikallinen esitys, joka koostuu rakenteen muodostamisesta yksittäiselle tietokannalle, kuten taulukoille, tallennetuille toimintosarjoille tai funktioille. SQL-tietokantaprojekti testataan yleensä paikallisesti kehittämällä se tiedostoon dacpac virheiden tarkistamista varten ennen sen käyttöönottoa SQL-kohdetietokantaan. SQL-tietokantaprojektin rakenne on riippuvainen tietokantaobjekteista, joissa Fabricin SQL-tietokanta järjestää projektitiedostot oletusarvoisesti rakenteen ja objektityypin mukaan. Esimerkiksi rakenteessa dbo nimettyä Table1 taulukkoa edustaa -tiedostopolkudbo/Tables/Table1.sql. Lisätietoja SQL-projekteista on SQL-projektien dokumentaatiossa.

Muotoilun sqlproj määritysosat

Tässä taulukossa on luettelo SQL-tietokannan sqlproj määritysosista.

Määritysosan polku tyyppi Pakollinen Description
sqldb.sqlproj SQL-tietokantaprojekti true .sqlproj on Microsoft.Build.Sql-projektin projektitiedosto. Se luodaan tiedostoon dacpac ja otetaan käyttöön SQL-kohdetietokannassa. Vain yksi SQL-projektitiedosto (.sqlproj) hyväksytään määritelmää kohden.
**/*.sql Structured Query Language (SQL) -tiedosto false Vähintään yksi SQL-objektimääritystiedosto. Kaikki tiedostot, joita tiedosto ei nimenomaisesti sulje pois, .sqlproj sisällytetään.
.sharedqueries/*.sql Structured Query Language (SQL) -tiedosto false Vähintään yksi SQL-kyselytiedosto. Nämä kyselyt otetaan käyttöön tietokannassa jaettuina kyselyinä ja ne ovat käytettävissä editorissa. Kansio .sharedqueries ei ole mukana SQL-projektitiedostossa, eivätkä nämä kyselyt sisälly koontiprosessiin.
.platform PlatformDetails (JSON) false Kuvaa kohteen yleisiä tietoja

Määritysten hyötykuorman esimerkki sqlproj-muotoa käyttämällä

{
  "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"
      }
    ]
  }
}