共用方式為

Microsoft Fabric 中 SQL 資料庫的 SqlPackage

  • 發行項

✅適用於：Microsoft Fabric 中的 SQL 資料庫

在本教學課程中，您會瞭解如何在 Fabric 的 SQL 資料庫中使用 SqlPackage。

SqlPackage 是 CLI，提供資料庫可移植性和資料庫部署。

  • 在 Azure 或 Fabric 中管理之資料庫的可移植性（匯入/匯出）可確保您的數據可移植到其他平臺，包括 SQL Server 或 Azure SQL 受控執行個體，如果您稍後想要移轉。
  • 相同的可移植性也會透過具有匯入/匯出作業的獨立資料庫複本 （.bacpac） 來啟用特定移轉案例。

SqlPackage 也可以對資料庫對象進行累加式變更的簡單資料庫部署（數據表中的新數據行、現有預存程式的變更等等）。

  • SqlPackage 可以擷取 .dacpac 包含資料庫中物件定義的檔案，併發佈檔案 .dacpac 以將該物件狀態套用至新的或現有的資料庫。
  • 發行作業也會與 SQL 專案整合，可讓 SQL 資料庫離線且更動態的開發週期。

必要條件

設定

SqlPackage 適用於 Windows、macOS 和 Linux 作為 dotnet 工具。 您可以使用下列命令安裝：

dotnet tool install --global Microsoft.SqlPackage

作為全域 dotnet 工具，SqlPackage 可在您的終端機中使用，就像從任何資料夾一樣 sqlpackage 。

使用 SqlPackage 匯入資料庫

.bacpac是資料庫的可攜式複本，適用於某些移轉和測試案例。 您可以將該匯.bacpac入空的 SQL 資料庫。

注意

.bacpac不是備份或取代備份/還原功能。 如需 Fabric SQL 資料庫中備份的詳細資訊，請參閱 Microsoft Fabric 中的 SQL 資料庫中自動備份和 從 Microsoft Fabric 中 SQL 資料庫中的備份還原。

  1. .bacpac如果您使用來自 Azure SQL 資料庫 環境的 ，您可能需要改變源資料庫以符合 Fabric SQL Database T-SQL 介面區。

  2. 透過網狀架構介面，如往常在 Fabric 中建立新的 SQL 資料庫。

  3. 從設定複製 連接字串。

    網狀架構入口網站的螢幕快照，其中顯示 SQL 資料庫的 [連接字串] 頁面。

  4. 使用 sqlpackage 資料夾中終端機的 import 命令。 提供您的擁有者與 <servername> <database_name>。

    sqlpackage /action:import /sourcefile:"C:\DatabaseName.bacpac" /targetconnectionstring:"Data Source=tcp:<server_name>.database.windows.net,1433;Initial Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive"
    • 從 [SQL 資料庫設定] 對話框取代您的 連接字串。
    • 將 sourcefile 值取代為 .bacpac 本機電腦上的名稱 （DatabaseName） 和 location 。

如需匯入的詳細資訊，請參閱 SqlPackage 匯入。

使用 SqlPackage 匯出資料庫

匯出 .bacpac 是反向作業，您可以在 [SQL 資料庫設定] 對話框中找到 您的 targetfile 和 .bacpac sourceconnectionstring ，如上一個範例所示。 提供您的擁有者與 <servername> <database_name>。 例如：

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

如需導出的詳細資訊，請參閱 SqlPackage 導出。

擷取和發佈

SQL 資料庫專案如何移動架構變更的圖表。

.dacpac是資料庫架構模型檔案，其中包含源資料庫中數據表、預存程式和其他物件的定義。

SqlPackage 能夠將 部署到 .dacpac 新的 （空白） 資料庫，或以累加方式更新現有的資料庫，以符合所需的 .dacpac 狀態。

  • 擷取 會 .dacpac 從現有的資料庫建立 或 sql 檔案。
  • 發佈 會將 .dacpac 部署至資料庫。

SqlPackage 發佈語法類似於匯入/導出命令。

相關內容