แชร์ผ่าน


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.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การส่งออก คือการดําเนินการย้อนกลับ ที่คุณtargetfileและ .bacpac sourceconnectionstring สามารถพบได้ในกล่องโต้ตอบการตั้งค่าฐานข้อมูล SQL ตามตัวอย่างก่อนหน้านี้ ให้เจ้าของ<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 สามารถย้ายการเปลี่ยนแปลง Schema ได้อย่างไร

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

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

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

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