다음을 통해 공유


PowerShell Core를 사용하여 Linux에서 SQL Server 관리

적용 대상: SQL Server - Linux

이 문서에서는 SQL Server PowerShell을 소개하고 macOS 및 Linux에서 PowerShell Core(PS Core)와 함께 사용하는 방법에 관한 몇 가지 예를 안내합니다. PowerShell Core는 현재 GitHub에 게시된 오픈 소스 프로젝트입니다.

플랫폼 간 편집기 옵션

PowerShell Core에 대한 다음 단계는 모두 일반 터미널에서 작동하거나 Visual Studio Code 또는 Azure Data Studio 내의 터미널에서 실행할 수 있습니다. Azure Data Studio와 VS Code는 모두 macOS와 Linux에서 사용할 수 있습니다. Azure Data Studio에 대한 자세한 내용은 빠른 시작: Azure Data Studio를 사용하여 SQL Server 연결 및 쿼리를 참조하세요. Azure Data Studio용 PowerShell 편집기 지원 사용을 고려할 수도 있습니다.

PowerShell Core 설치

지원되는 다양한 실험적 플랫폼에 PowerShell Core를 설치하는 방법에 대한 자세한 내용은 다음 문서를 참조하세요.

SqlServer 모듈 설치

SqlServer 모듈은 PowerShell 갤러리에서 유지 관리됩니다. SQL Server로 작업하는 경우 항상 최신 버전의 SqlServer PowerShell 모듈을 사용해야 합니다.

SqlServer 모듈을 설치하려면 PowerShell Core 세션을 열고 다음 코드를 실행합니다.

Install-Module -Name SqlServer

PowerShell 갤러리에서 SqlServer 모듈을 설치하는 방법에 대한 자세한 내용은 SQL Server PowerShell 모듈 설치를 참조하세요.

SqlServer 모듈 사용하기

먼저 PowerShell Core를 시작해 보겠습니다. macOS 또는 Linux를 사용하는 경우 컴퓨터에서 터미널 세션을 열고 pwsh를 입력 하여 새 PowerShell Core 세션을 시작합니다. Windows에서 Win+R을 사용하고 pwsh를 입력하여 새 PowerShell Core 세션을 시작합니다.

pwsh

SQL Server는 SqlServer라는 PowerShell 모듈을 제공합니다. SqlServer 모듈을 사용하여 SQL Server 구성 요소(SQL Server 공급자 및 cmdlet)를 PowerShell 환경 또는 스크립트로 가져올 수 있습니다.

PowerShell 프롬프트에서 다음 명령을 복사하여 붙여넣어 SqlServer 모듈을 현재 PowerShell 세션으로 가져옵니다.

Import-Module SqlServer

PowerShell 프롬프트에 다음 명령을 입력하여 SqlServer 모듈을 올바르게 가져왔는지 확인합니다.

Get-Module -Name SqlServer

PowerShell은 다음 출력과 유사한 정보를 표시해야 합니다.

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

SQL Server에 연결 및 서버 정보 가져오기

다음 단계는 Windows에서 PowerShell Core를 사용하여 Linux의 SQL Server 인스턴스에 연결하고 몇 가지 서버 속성을 표시하겠습니다.

PowerShell 프롬프트에서 다음 명령을 복사하여 붙여넣습니다. 이러한 명령을 실행하면 PowerShell에서 다음을 수행합니다.

  • 인스턴스의 호스트 이름 또는 IP 주소를 입력하라는 대화 상자를 표시합니다
  • 자격 증명을 묻는 PowerShell 자격 증명 요청 대화 상자를 표시합니다. SQL 사용자 이름SQL 암호를 사용하여 Linux의 SQL Server 인스턴스에 연결할 수 있습니다
  • Get-SqlInstance cmdlet을 사용하여 서버에 연결하고 몇 가지 속성을 표시합니다

필요에 따라 $serverInstance 변수를 SQL Server 인스턴스의 IP 주소 또는 호스트 이름으로 바꿀 수 있습니다.

# 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은 다음 출력과 유사한 정보를 표시해야 합니다.

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

참고 항목

이러한 값 중 아무것도 표시되지 않으면 대상 SQL Server 인스턴스에 연결되지 않았을 수 있습니다. 동일한 연결 정보를 사용하여 SQL Server Management Studio에서 연결할 수 있는지 확인합니다. 그런 다음 connection troubleshooting recommendations(연결 문제 해결 권장 사항)를 검토합니다.

SQL Server PowerShell 공급자 사용

SQL Server 인스턴스에 연결하는 또 다른 옵션은 SQL Server PowerShell 공급자를 사용하는 것입니다. 공급자를 사용하면 개체 탐색기 트리 구조를 탐색하는 것처럼 cmdline에서 SQL Server 인스턴스를 탐색할 수 있습니다. 기본적으로 이 공급자는 도메인 계정이 액세스할 수 SQL Server 인스턴스를 연결 및 탐색하는 데 사용할 수 있는 SQLSERVER:\라는 PSDrive로 표시됩니다. Linux에서 SQL Server용 Active Directory 인증을 설정하는 방법에 대한 자세한 내용은 구성 단계를 참조하세요.

SQL Server PowerShell 공급자에서 SQL 인증을 사용할 수도 있습니다. 이렇게 하려면 New-PSDrive cmdlet을 사용하여 새 PSDrive을 만들고 연결할 적절한 자격 증명을 제공합니다.

아래 예제에서는 SQL 인증을 사용하여 새 PSDrive를 만드는 방법의 한 가지 예를 보여 줍니다.

# 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

Get-PSDrive cmdlet을 실행하여 드라이브가 생성되었는지 확인할 수 있습니다.

Get-PSDrive

새 PSDrive를 만들었으면 드라이브 탐색을 시작할 수 있습니다.

dir SQLonDocker:\Databases

출력은 다음과 같습니다. 이 출력은 SSMS가 데이터베이스 노드에 표시하는 내용과 유사합니다. 사용자 데이터베이스를 표시하지만 시스템 데이터베이스는 표시하지 않습니다.

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

인스턴스의 모든 데이터베이스를 확인해야 하는 경우 Get-SqlDatabase cmdlet을 사용할 수 있습니다.

데이터베이스 가져오기

알아야 할 중요한 cmdlet은 Get-SqlDatabase입니다. 데이터베이스 또는 데이터베이스 내의 개체를 사용하는 많은 작업에서 Get-SqlDatabase cmdlet을 사용할 수 있습니다. -ServerInstance-Database 매개 변수의 값을 둘 다 제공하는 경우 해당 데이터베이스 개체 하나만 검색됩니다. 그러나 -ServerInstance 매개 변수만 지정하면 해당 인스턴스에 있는 모든 데이터베이스의 전체 목록이 반환됩니다.

# 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

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

SQL Server 오류 로그 검토

다음 단계에서는 PowerShell Core을 사용하여 Linux의 SQL Server 인스턴스에서 오류 로그 연결을 검사합니다.

PowerShell 프롬프트에서 다음 명령을 복사하여 붙여넣습니다. 실행하는 데 몇 분 정도 걸릴 수 있습니다. 이러한 단계를 완료하고 나서 다음을 수행합니다.

  • 인스턴스의 호스트 이름 또는 IP 주소를 입력하라는 대화 상자를 표시합니다
  • 자격 증명을 묻는 PowerShell 자격 증명 요청 대화 상자를 표시합니다. SQL 사용자 이름SQL 암호를 사용하여 Linux의 SQL Server 인스턴스에 연결할 수 있습니다
  • Get-SqlErrorLog cmdlet을 사용하여 Linux의 SQL Server 인스턴스에 연결하고 어제부터 오류 로그를 검색합니다

필요에 따라 $serverInstance 변수를 SQL Server 인스턴스의 IP 주소 또는 호스트 이름으로 바꿀 수 있습니다.

# 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

PowerShell Core에서 현재 사용할 수 있는 cmdlet 살펴보기

SqlServer 모듈에는 현재 Windows PowerShell에서 사용할 수 있는 109개 cmdlet이 있지만 PSCore에서는 109개 중 62개만 사용할 수 있습니다. 다음은 현재 사용할 수 있는 62 cmdlet의 전체 목록입니다. SqlServer 모듈의 모든 cmdlet에 대한 자세한 설명서는 SqlServer cmdlet 참조를 참조하세요.

다음 명령은 사용 중인 PowerShell 버전에서 사용할 수 있는 모든 cmdlet을 보여 줍니다.

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