Jaa

SQLPackage for SQL -tietokanta Microsoft Fabricissa

Koskee Microsoft Fabricin SQL-tietokantaa✅

Tässä opetusohjelmassa opit käyttämään SqlPackagea SQL-tietokannassa Fabricissa.

SqlPackage on komentorivikäyttöliittymä, joka tarjoaa tietokannan siirrettävyyden ja tietokannan käyttöönotot.

  • Azuressa tai Fabricissa hallitun tietokannan siirrettävyys (tuonti/vienti) varmistaa, että tiedot siirretään muihin käyttöympäristöihin, jos haluat siirtää ne myöhemmin. - Siirrettävyys sisältää siirtämisen SQL Serveriin, Azuren SQL-tietokantaan, Azure SQL:n hallittuun esiintymään ja SQL-tietokantaan Fabricissa itsenäisten tietokantakopiokkeiden (.bacpac tai .dacpac tiedostojen kautta).

SqlPackage mahdollistaa myös tietokantaobjektien lisäävien muutosten käyttöönoton helposti (uudet sarakkeet taulukoissa, muutokset olemassa oleviin tallennettuihin toimintosarjoihin jne.).

  • SqlPackage voi purkaa .dacpac tiedoston, joka sisältää tietokannan objektien määritykset, ja julkaista .dacpac tiedoston, joka käyttää kyseistä objektitilaa uudessa tai olemassa olevassa tietokannassa.
  • Julkaisutoiminto integroituu myös SQL-projekteihin, jotka mahdollistavat SQL-tietokantojen offline-tilassa ja dynaamisemmat kehitysjaksot.

Edellytykset

Asetusten määrittäminen

SqlPackage on saatavilla Windowsille, macOS:lle ja Linuxille dotnet-työkaluna. Voit asentaa sen seuraavan komennon avulla:

dotnet tool install --global Microsoft.SqlPackage

Yleisenä dotnet-työkaluna SqlPackage on käytettävissä päätteessä missä sqlpackage tahansa kansiossa.

Tietokannan tuominen SqlPackage-paketin avulla

on .bacpac tietokannan siirrettävä kopio, joka on hyödyllinen joissakin siirto- ja testaustilanteissa. Voit tuoda sen .bacpac tyhjään SQL-tietokantaan SqlPackage-tuonnin avulla.

Muistiinpano

.bacpac ei ole varmuuskopiointi- tai korvaus varmuuskopiointi- tai palautustoiminnoille. Katso lisätietoja SQL-tietokannan varmuuskopioista Fabricissa artikkelista Automaattiset varmuuskopiot SQL-tietokannassa Microsoft Fabricissa ja Palauttaminen SQL-tietokannan varmuuskopiosta Microsoft Fabricissa.

  1. Jos käytät Azure- .bacpac tai SQL Server -ympäristöä, sinun on ehkä muokattava lähdetietokantaa niin, että se täyttää SQL-tietokannan Fabric T-SQL Surface -alueella. Katso kohdasta Poimi ja julkaise siirrettävyys vaihtoehtoinen menetelmä, jonka avulla SqlPackage-ominaisuudet voivat ohittaa joitakin objekteja, joita ei tueta.

  2. Luo uusi SQL-tietokanta Fabricissa tavalliseen tapaan Fabric-käyttöliittymän kautta.

  3. Kopioi yhteysmerkkijono asetuksista.

    Kangasportaalin näyttökuva, jossa näkyy SQL-tietokannan yhteysmerkkijonojen sivu.

  4. Käytä sqlpackage-kansion tuo-komentoa päätteestä. Anna omistaja <servername> ja <database_name>.

    sqlpackage /action:import /sourcefile:"C:\DatabaseName.bacpac" /targetconnectionstring:"Data Source=tcp:<server_name>.database.fabric.microsoft.com,1433;Initial Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive"
    • Korvaa yhteysmerkkijono SQL-tietokannan asetukset -valintaikkunassa.
    • sourcefile Korvaa arvo .bacpac nimellä (DatabaseName) ja location paikallisessa tietokoneessa.

  5. Seuraa tuontia kopiointityöllä Microsoft Fabricin Data Factoryssa. Aloita artikkelissa Pika-aloitus: Kopiointityön luominen.

Tietokannan vieminen SqlPackage-paketin avulla

.bacpac Kohteen vienti on käänteinen toiminto, jossa targetfile on ja .bacpac joka sijaitsee sourceconnectionstring SQL-tietokanta-asetusten valintaikkunassa edellisen esimerkin mukaisesti. Anna omistaja <servername> ja <database_name>. Esimerkkejä:

sqlpackage /action:export /targetfile:"C:\DatabaseName.bacpac" /sourceconnectionstring:"Data Source=tcp:<server_name>.database.fabric.microsoft.com,1433;Initial Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive"

Lisätietoja viennistä on artikkelissa SqlPackage-vienti.

Poimi ja julkaise

Kaavio siitä, miten SQL-tietokantaprojektit voivat siirtää rakenteen muutoksia.

on .dacpac tietokannan rakennemallitiedosto, joka sisältää määritysten taulukoille, tallennetuille toimintosarjoille ja muille lähdetietokannan objekteille. Tämä tiedosto voidaan luoda olemassa olevasta tietokannasta SqlPackagella tai SQL-tietokantaprojektista.

SqlPackage pystyy ottamaan käyttöön uuden (tyhjän .dacpac ) tietokannan tai päivittämään olemassa olevan tietokannan asteittain halutun .dacpac tilan mukaiseksi.

  • Poimii luo - .dacpac tai sql-tiedostot olemassa olevasta tietokannasta.
  • Julkaiseminen ottaa käyttöön -käyttöönoton tietokannassa .dacpac .

SqlPackage-julkaise ja poimitaan-syntaksi muistuttaa tuonti- ja vientikomentoja.

Varoitus

SqlPackage-toiminnon käyttäminen SQL-projektin tai .dacpac käyttöönottoon SQL-tietokannassa Fabricissa on suositeltavaa. .dacpac käyttöönotto Visual Studiosta voi epäonnistua.

Jos haluat ottaa käyttöön Azure SQL -tietokannasta, SQL Serveristä tai SQL-projektista luodun .dacpac, joka on suunnattu muuhun kuin SQL-tietokantaan Fabricissa, liitä /p:AllowIncompatiblePlatform=true -ominaisuus SqlPackage-julkaisukomentoon.

Siirrettävyyden poimiminen ja julkaiseminen

Vaikka SqlPackage-tuonti- ja vientikomennot keskittyvät tietojen siirrettävyyteen .bacpac -muodossa, poiminta- ja julkaisukomennot pystyvät tietojen siirrettävyyteen - .dacpac muodossa. Poimi ja julkaise ominaisuuksia voidaan käyttää poiminta- ja julkaisutoimintojen käyttäytymisen ohjaamiseen ja lisätä joustavuutta ympäristöjen välisten muunnosten kanssa.

Jos haluat poimia.dacpac ja sisällyttää tiedot, käytä -ominaisuutta /p:ExtractAllTableData=true . Poimintatoiminto luo kohteen .dacpac , joka sisältää sekä rakenteen että lähdetietokannan tiedot. -ominaisuus /p:ExtractReferencedServerScopedElements=false jättää pois palvelinlaajentetut elementit, joita ei tueta SQL-tietokannassa Fabricissa. Seuraava komento poimii tiedot .dacpac olemassa olevasta SQL-tietokannasta Fabricissa:

sqlpackage /action:extract /sourceconnectionstring:"Data Source=tcp:<server_name>.database.fabric.microsoft.com,1433;Initial Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive" /targetfile:"C:\extracted.dacpac" /p:ExtractAllTableData=true  /p:ExtractReferencedServerScopedElements=false

Jos haluat julkaista.dacpac tiedoista poimitun kohteen, se ei vaadi ylimääräisiä ominaisuuksia. Julkaisutoiminnon toimintaa voidaan kuitenkin hallita useilla ominaisuuksilla:

  • /p:AllowIncompatiblePlatform=true mahdollistaa eri ympäristöstä .dacpac (esimerkiksi Azure SQL -tietokannasta, SQL Serveristä) poimitun käyttöympäristön käyttöönoton.
  • /p:ExcludeObjectTypes=Logins;Users sulkee pois objektityypit, jotka saattavat kohdata yhteensopivuusongelmia julkaistaessa sql-tietokantaan Fabricissa. Täydellinen luettelo pois jätetyistä objektityypeistä on kohdassa SqlPackage publish.

SqlPackage-tuontikomennon tavoin sinun on luotava tietokanta Fabricissa ennen SQL-tietokannan julkaisemista .dacpac Fabricissa. Voit luoda tietokannan Fabric-portaalin tai muun Fabric-käyttöliittymän kautta. Seuraava komento julkaisee Fabricissa poimitut tiedot .dacpac tyhjään SQL-tietokantaan:

sqlpackage /action:publish /sourcefile:"C:\extracted.dacpac" /targetconnectionstring:"Data Source=tcp:<server_name>.database.fabric.microsoft.com,1433;Initial Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive" /p:AllowIncompatiblePlatform=true /p:ExcludeObjectTypes=Logins;Users

Liittyvä sisältö

  • Last updated on