แชร์ผ่าน

SqlPackage สําหรับฐานข้อมูล SQL ใน Microsoft Fabric

  • บทความ

นําไปใช้กับ:✅ฐานข้อมูล SQL ใน Microsoft Fabric

ในบทช่วยสอนนี้ คุณจะได้เรียนรู้วิธีการทํางานกับ SqlPackage ในฐานข้อมูล SQL ของคุณใน Fabric

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 ดูการสํารองข้อมูลอัตโนมัติในฐานข้อมูล SQL ใน Microsoft Fabric และ Restore จากการสํารองข้อมูลในฐานข้อมูล SQL ใน Microsoft Fabric

  1. ถ้าใช้ .bacpac จากสภาพแวดล้อมฐานข้อมูล Azure SQL ของคุณ คุณอาจจําเป็นต้องเปลี่ยนฐานข้อมูลต้นฉบับเพื่อให้ตรงกับพื้นที่พื้นผิว T-SQL ของฐานข้อมูล Fabric SQL

  2. สร้างฐานข้อมูล SQL ใหม่ของคุณใน Fabric ตามปกติผ่านอินเทอร์เฟซ Fabric

  3. คัดลอกสายอักขระการเชื่อมต่อจากการตั้งค่า

    ภาพหน้าจอจากพอร์ทัล Fabric ที่แสดงหน้าสตริงการเชื่อมต่อของฐานข้อมูล SQL

  4. ใช้คําสั่งนําเข้าจากเทอร์มินัลในโฟลเดอร์ sqlpackage ให้เจ้าของ<servername>ของคุณ และ<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"
    • แทนที่สายอักขระการเชื่อมต่อของคุณจากกล่องโต้ตอบการตั้งค่าฐานข้อมูล SQL
    • sourcefileแทนที่ค่า ด้วย.bacpacชื่อ (DatabaseName) และlocationบนเครื่องคอมพิวเตอร์ของคุณ

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการนําเข้า โปรดดู การนําเข้า SqlPackage

ส่งออกฐานข้อมูลด้วย SqlPackage

.bacpacการส่งออก คือการดําเนินการย้อนกลับ ที่คุณtargetfileและ .bacpacsourceconnectionstring สามารถพบได้ในกล่องโต้ตอบการตั้งค่าฐานข้อมูล SQL ตามตัวอย่างก่อนหน้านี้ ให้เจ้าของ<servername>ของคุณ และ<database_name> ตัวอย่างเช่น:

sqlpackage.exe /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"

สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการส่งออก โปรดดู การส่งออก SqlPackage

แยกและเผยแพร่

แผนภาพว่าโครงการฐานข้อมูล SQL สามารถย้ายการเปลี่ยนแปลง Schema ได้อย่างไร

.dacpacเป็นไฟล์แบบจําลองเค้าร่างฐานข้อมูลที่มีข้อกําหนดสําหรับตาราง กระบวนงานที่เก็บไว้ และวัตถุอื่นๆ ในฐานข้อมูลต้นทาง ไฟล์นี้สามารถสร้างจากฐานข้อมูลที่มีอยู่ด้วย SqlPackage หรือจากโครงการฐานข้อมูล SQL

SqlPackage มีความสามารถในการปรับใช้.dacpacไปยังฐานข้อมูลใหม่ (ว่าง) หรือปรับปรุงฐานข้อมูลที่มีอยู่ให้ตรงกับสถานะที่ต้องการ.dacpac

  • การแยก จะสร้าง .dacpac ไฟล์ sql หรือจากฐานข้อมูลที่มีอยู่
  • เผยแพร่ ปรับใช้กับ .dacpac ฐานข้อมูล

SqlPackage เผยแพร่ และ แยกไวยากรณ์ คล้ายกับคําสั่งนําเข้า/ส่งออก

คำเตือน

แนะนําให้ใช้ SqlPackage เพื่อปรับใช้โครงการ SQL หรือ .dacpac กับฐานข้อมูล SQL ใน Fabric การปรับใช้ .dacpac จาก Visual Studio อาจไม่สําเร็จ

เมื่อต้องการปรับใช้ .dacpac ที่สร้างขึ้นจากฐานข้อมูล Azure SQL, SQL Server หรือโครงการ SQL ที่กําหนดเป้าหมายแพลตฟอร์มอื่นนอกเหนือจากฐานข้อมูล SQL ใน Fabric ให้ผนวกคุณสมบัติ /p:AllowIncompatiblePlatform=true เข้ากับคําสั่งการเผยแพร่ SqlPackage

เนื้อหาที่เกี่ยวข้อง