Bagikan melalui


Mengelola SQL Server di Linux dengan PowerShell Core

Berlaku untuk: SQL Server - Linux

Artikel ini memperkenalkan SQL Server PowerShell dan memancang Anda melalui beberapa contoh tentang cara menggunakannya dengan PowerShell Core (PS Core) di macOS & Linux. PowerShell Core sekarang menjadi proyek Sumber Terbuka di GitHub.

Opsi editor lintas platform

Semua langkah berikut untuk pekerjaan PowerShell Core di terminal reguler, atau Anda dapat menjalankannya dari terminal dalam Visual Studio Code atau Azure Data Studio. Vs Code dan Azure Data Studio tersedia di macOS dan Linux. Untuk informasi selengkapnya tentang Azure Data Studio, lihat Mulai Cepat: Menggunakan Azure Data Studio untuk menyambungkan dan mengkueri SQL Server. Anda mungkin juga ingin mempertimbangkan untuk menggunakan Dukungan Editor PowerShell untuk Azure Data Studio.

Menginstal PowerShell Core

Untuk informasi selengkapnya tentang menginstal PowerShell Core di berbagai platform yang didukung dan eksperimental, lihat artikel berikut ini:

Menginstal modul SqlServer

Modul SqlServer dipertahankan di Galeri PowerShell. Saat bekerja dengan SQL Server, Anda harus selalu menggunakan versi terbaru modul SqlServer PowerShell.

Untuk menginstal modul SqlServer, buka sesi PowerShell Core dan jalankan kode berikut:

Install-Module -Name SqlServer

Untuk informasi selengkapnya tentang cara menginstal modul SqlServer dari Galeri PowerShell, lihat Menginstal modul PowerShell SQL Server.

Menggunakan modul SqlServer

Mari kita mulai dengan meluncurkan PowerShell Core. Jika Anda menggunakan macOS atau Linux, Buka sesi terminal di komputer Anda, dan ketik pwsh untuk meluncurkan sesi PowerShell Core baru. Di Windows, gunakan Win+R, dan ketik pwsh untuk meluncurkan sesi PowerShell Core baru.

pwsh

SQL Server menyediakan modul PowerShell bernama SqlServer. Anda dapat menggunakan modul SqlServer untuk mengimpor komponen SQL Server (penyedia dan cmdlet SQL Server) ke lingkungan atau skrip PowerShell.

Salin dan tempel perintah berikut pada prompt PowerShell untuk mengimpor modul SqlServer ke sesi PowerShell Anda saat ini:

Import-Module SqlServer

Ketik perintah berikut pada perintah PowerShell untuk memverifikasi bahwa modul SqlServer diimpor dengan benar:

Get-Module -Name SqlServer

PowerShell harus menampilkan informasi yang mirip dengan output berikut:

ModuleType Version    Name          ExportedCommands
---------- -------    ----          ----------------
Script     21.1.18102 SqlServer     {Add-SqlAvailabilityDatabase, Add-SqlAvailabilityGroupList...

Menyambungkan ke SQL Server dan mendapatkan informasi server

Langkah-langkah berikut menggunakan PowerShell Core untuk menyambungkan ke instans SQL Server Anda di Linux dan menampilkan beberapa properti server.

Salin dan tempel perintah berikut ini di prompt PowerShell. Saat Anda menjalankan perintah ini, PowerShell akan:

  • Menampilkan dialog yang meminta nama host atau alamat IP instans Anda
  • Tampilkan dialog permintaan kredensial PowerShell, yang meminta kredensial kepada Anda. Anda dapat menggunakan nama pengguna SQL dan kata sandi SQL Anda untuk menyambungkan ke instans SQL Server Anda di Linux
  • Gunakan cmdlet Get-SqlInstance untuk menyambungkan ke Server dan menampilkan beberapa properti

Secara opsional, Anda hanya dapat mengganti $serverInstance variabel dengan alamat IP atau nama host instans SQL Server Anda.

# Prompt for instance & credentials to login into SQL Server
$serverInstance = Read-Host "Enter the name of your instance"
$credential = Get-Credential

# Connect to the Server and return a few properties
Get-SqlInstance -ServerInstance $serverInstance -Credential $credential
# done

PowerShell harus menampilkan informasi yang mirip dengan output berikut:

Instance Name                   Version    ProductLevel UpdateLevel  HostPlatform HostDistribution
-------------                   -------    ------------ -----------  ------------ ----------------
your_server_instance            14.0.3048  RTM          CU13         Linux        Ubuntu

Catatan

Jika tidak ada yang ditampilkan untuk nilai-nilai ini, koneksi ke instans SQL Server target kemungkinan besar gagal. Pastikan Anda dapat menggunakan informasi koneksi yang sama untuk menyambungkan dari SQL Server Management Studio. Kemudian tinjau rekomendasi pemecahan masalah koneksi.

Menggunakan Penyedia PowerShell SQL Server

Opsi lain untuk menyambungkan ke instans SQL Server Anda adalah menggunakan Penyedia PowerShell SQL Server. Menggunakan penyedia memungkinkan Anda menavigasi instans SQL Server yang mirip dengan seolah-olah Anda menavigasi struktur pohon di Object Explorer, tetapi di cmdline. Secara default penyedia ini disajikan sebagai PSDrive bernama SQLSERVER:\, yang dapat Anda gunakan untuk menyambungkan & menavigasi instans SQL Server yang dapat diakses akun domain Anda. Lihat Langkah-langkah konfigurasi untuk informasi tentang cara menyiapkan autentikasi Direktori Aktif untuk SQL Server di Linux.

Anda juga dapat menggunakan autentikasi SQL dengan Penyedia PowerShell SQL Server. Untuk melakukan ini, gunakan New-PSDrive cmdlet untuk membuat PSDrive baru dan berikan kredensial yang tepat untuk menyambungkan.

Dalam contoh berikut, Anda akan melihat contoh cara membuat PSDrive baru menggunakan autentikasi SQL.

# NOTE: We are reusing the values saved in the $credential variable from the above example.

New-PSDrive -Name SQLonDocker -PSProvider SqlServer -Root 'SQLSERVER:\SQL\localhost,10002\Default\' -Credential $credential

Anda dapat mengonfirmasi bahwa drive dibuat dengan menjalankan Get-PSDrive cmdlet.

Get-PSDrive

Setelah membuat PSDrive baru, Anda bisa mulai menavigasinya.

dir SQLonDocker:\Databases

Berikut adalah tampilan outputnya. Anda mungkin melihat output ini mirip dengan apa yang ditampilkan SSMS di simpul Database. Ini menampilkan database pengguna, tetapi bukan database sistem.

Name                 Status           Size     Space  Recovery Compat. Owner
                                            Available  Model     Level
----                 ------           ---- ---------- -------- ------- -----
AdventureWorks2022   Normal      209.63 MB    1.31 MB Simple       130 sa
AdventureWorksDW2022 Normal      167.00 MB   32.47 MB Simple       110 sa
AdventureWorksDW2022 Normal      188.00 MB   78.10 MB Simple       120 sa
AdventureWorksDW2022 Normal      172.00 MB   74.76 MB Simple       130 sa
AdventureWorksDW2022 Normal      208.00 MB   40.57 MB Simple       140 sa

Jika Anda perlu melihat semua database pada instans Anda, salah satu opsinya adalah menggunakan Get-SqlDatabase cmdlet.

Mendapatkan Database

Cmdlet penting yang perlu diketahui adalah Get-SqlDatabase. Untuk banyak operasi yang melibatkan database, atau objek dalam database, Get-SqlDatabase cmdlet dapat digunakan. Jika Anda menyediakan nilai untuk -ServerInstance parameter dan -Database , hanya satu objek database yang diambil. Namun, jika Anda hanya -ServerInstance menentukan parameter, daftar lengkap semua database pada instans tersebut akan dikembalikan.

# NOTE: We are reusing the values saved in the $credential variable from the above example.

# Connect to the Instance and retrieve all databases
Get-SqlDatabase -ServerInstance ServerB -Credential $credential

Berikut adalah sampel apa yang dikembalikan perintah Get-SqlDatabase:

Name                 Status           Size     Space  Recovery Compat. Owner
                                            Available  Model     Level
----                 ------           ---- ---------- -------- ------- -----
AdventureWorks2022   Normal      209.63 MB    1.31 MB Simple       130 sa
AdventureWorksDW2022 Normal      167.00 MB   32.47 MB Simple       110 sa
AdventureWorksDW2022 Normal      188.00 MB   78.10 MB Simple       120 sa
AdventureWorksDW2022 Normal      172.00 MB   74.88 MB Simple       130 sa
AdventureWorksDW2022 Normal      208.00 MB   40.63 MB Simple       140 sa
master               Normal        6.00 MB  600.00 KB Simple       140 sa
model                Normal       16.00 MB    5.70 MB Full         140 sa
msdb                 Normal       15.50 MB    1.14 MB Simple       140 sa
tempdb               Normal       16.00 MB    5.49 MB Simple       140 sa

Memeriksa log kesalahan SQL Server

Langkah-langkah berikut menggunakan PowerShell Core untuk memeriksa log kesalahan yang terhubung pada instans SQL Server Anda di Linux.

Salin dan tempel perintah berikut ini di prompt PowerShell. Mungkin perlu waktu beberapa menit untuk dijalankan. Perintah ini melakukan langkah-langkah berikut:

  • Menampilkan dialog yang meminta nama host atau alamat IP instans Anda
  • Tampilkan dialog permintaan kredensial PowerShell yang meminta kredensial kepada Anda. Anda dapat menggunakan nama pengguna SQL dan kata sandi SQL Anda untuk menyambungkan ke instans SQL Server Anda di Linux
  • Gunakan cmdlet Get-SqlErrorLog untuk menyambungkan ke instans SQL Server di Linux dan mengambil log kesalahan sejak Kemarin

Secara opsional, Anda dapat mengganti $serverInstance variabel dengan alamat IP atau nama host instans SQL Server Anda.

# Prompt for instance & credentials to login into SQL Server
$serverInstance = Read-Host "Enter the name of your instance"
$credential = Get-Credential

# Retrieve error logs since yesterday
Get-SqlErrorLog -ServerInstance $serverInstance -Credential $credential -Since Yesterday
# done

Menjelajahi cmdlet yang saat ini tersedia di PowerShell Core

Sementara modul SqlServer saat ini memiliki 109 cmdlet yang tersedia di Windows PowerShell, hanya 62 dari 109 yang tersedia di PSCore. Berikut ini adalah daftar lengkap 62 cmdlet yang saat ini tersedia. Untuk dokumentasi mendalam semua cmdlet dalam modul SqlServer, lihat referensi cmdlet SqlServer.

Perintah berikut menunjukkan kepada Anda semua cmdlet yang tersedia pada versi PowerShell yang Anda gunakan.

Get-Command -Module SqlServer -CommandType Cmdlet |
Sort-Object -Property Noun |
SELECT Name
  • ConvertFrom-EncodedSqlName
  • ConvertTo-EncodedSqlName
  • Get-SqlAgent
  • Get-SqlAgentJob
  • Get-SqlAgentJobHistory
  • Get-SqlAgentJobSchedule
  • Get-SqlAgentJobStep
  • Get-SqlAgentSchedule
  • Invoke-SqlAssessment
  • Get-SqlAssessmentItem
  • Remove-SqlAvailabilityDatabase
  • Resume-SqlAvailabilityDatabase
  • Add-SqlAvailabilityDatabase
  • Suspend-SqlAvailabilityDatabase
  • New-SqlAvailabilityGroup
  • Set-SqlAvailabilityGroup
  • Remove-SqlAvailabilityGroup
  • Switch-SqlAvailabilityGroup
  • Join-SqlAvailabilityGroup
  • Revoke-SqlAvailabilityGroupCreateAnyDatabase
  • Grant-SqlAvailabilityGroupCreateAnyDatabase
  • New-SqlAvailabilityGroupListener
  • Set-SqlAvailabilityGroupListener
  • Add-SqlAvailabilityGroupListenerStaticIp
  • Set-SqlAvailabilityReplica
  • Remove-SqlAvailabilityReplica
  • New-SqlAvailabilityReplica
  • Set-SqlAvailabilityReplicaRoleToSecondary
  • New-SqlBackupEncryptionOption
  • Get-SqlBackupHistory
  • Invoke-Sqlcmd
  • New-SqlCngColumnMasterKeySettings
  • Remove-SqlColumnEncryptionKey
  • Get-SqlColumnEncryptionKey
  • Remove-SqlColumnEncryptionKeyValue
  • Add-SqlColumnEncryptionKeyValue
  • Get-SqlColumnMasterKey
  • Remove-SqlColumnMasterKey
  • New-SqlColumnMasterKey
  • Get-SqlCredential
  • Set-SqlCredential
  • New-SqlCredential
  • Remove-SqlCredential
  • New-SqlCspColumnMasterKeySettings
  • Get-SqlDatabase
  • Restore-SqlDatabase
  • Backup-SqlDatabase
  • Set-SqlErrorLog
  • Get-SqlErrorLog
  • New-SqlHADREndpoint
  • Set-SqlHADREndpoint
  • Get-SqlInstance
  • Add-SqlLogin
  • Remove-SqlLogin
  • Get-SqlLogin
  • Set-SqlSmartAdmin
  • Get-SqlSmartAdmin
  • Read-SqlTableData
  • Write-SqlTableData
  • Read-SqlViewData
  • Read-SqlXEvent
  • Convert-UrnToPath