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

아티클
11/19/2023

적용 대상:SQL Server - Linux

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

플랫폼 간 편집기 옵션

PowerShell Core에 대한 다음 단계는 모두 일반 터미널에서 작동하거나 Visual Studio Code 또는 Azure Data Studio 내의 터미널에서 실행할 수 있습니다. VS Code와 Azure Data Studio는 모두 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에 연결 및 서버 정보 가져오기

다음 단계에서는 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 인스턴스를 탐색할 수 있습니다. 기본적으로 이 공급자는 이름이 PSDriveSQLSERVER:\로 표시되며, 이 PSDrive를 사용하여 할 일기본 계정에 액세스할 수 있는 SQL Server 인스턴스를 연결하고 탐색할 수 있습니다. SQL Server on Linux에 대한 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

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

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을 사용할 수 있습니다. 매개 변수와 -Database 매개 변수 모두에 -ServerInstance 대한 값을 제공하는 경우 하나의 데이터베이스 개체만 검색됩니다. 그러나 매개 변수만 -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-SqlCngColumnMasterKey설정
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-SqlSmart관리
Get-SqlSmart관리
Read-SqlTableData
Write-SqlTableData
Read-SqlViewData
Read-SqlXEvent
Convert-UrnToPath

SQL Server PowerShell

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

플랫폼 간 편집기 옵션

PowerShell Core 설치

SqlServer 모듈 설치

SqlServer 모듈 사용

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

SQL Server PowerShell 공급자 사용

데이터베이스 가져오기

SQL Server 오류 로그 검사

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

피드백

피드백

추가 리소스

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

플랫폼 간 편집기 옵션

PowerShell Core 설치

SqlServer 모듈 설치

SqlServer 모듈 사용

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

SQL Server PowerShell 공급자 사용

데이터베이스 가져오기

SQL Server 오류 로그 검사

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

관련 콘텐츠

피드백

피드백

추가 리소스