Uso de PowerShell en Windows para administrar SQL Server en Linux
Se aplica a: 
SQL Server - Linux
En este artículo se presenta SQL Server PowerShell y se describen un par de ejemplos sobre cómo usarlo con SQL Server en Linux. Actualmente, la compatibilidad de PowerShell con SQL Server está disponible en Windows, macOS y Linux. Este artículo le guiará a través del uso de un equipo Windows para conectarse a una instancia de SQL Server remota en Linux.
Instalación de la versión más reciente de SQL PowerShell en Windows
El módulo SQL Server PowerShell en Windows se mantiene en la Galería de PowerShell. Cuando trabaje con SQL Server, siempre debe usar la versión más reciente del módulo de SqlServer PowerShell.
Antes de empezar
Lea los Problemas conocidos de SQL Server en Linux.
Iniciar PowerShell e importar el módulo sqlserver
Comenzaremos por iniciar PowerShell en Windows. Use Win+R, en el equipo Windows y escriba PowerShell para iniciar una nueva sesión de Windows PowerShell.
SQL Server proporciona un módulo de PowerShell denominado SqlServer. Puede usar el módulo SQLServer para importar los componentes de SQL Server (proveedores y cmdlets de SQL Server) en un script o un entorno de PowerShell.
Copie y pegue el siguiente comando en el símbolo del sistema de PowerShell para importar el módulo SqlServer en la sesión actual de PowerShell:
Import-Module SqlServer
Escriba el siguiente comando en el símbolo del sistema de PowerShell para comprobar que el módulo SqlServer se ha importado correctamente:
Get-Module -Name SqlServer
PowerShell debe mostrar información similar al siguiente resultado:
ModuleType Version Name ExportedCommands
---------- ------- ---- ----------------
Script 21.1.18102 SqlServer {Add-SqlAvailabilityDatabase, Add-SqlAvailabilityGroupList...
Conectarse a SQL Server y obtener información del servidor
Vamos a usar PowerShell en Windows para conectar con la instancia de SQL Server en Linux y mostrar un par de propiedades de servidor.
Copie y pegue los siguientes comandos en el símbolo del sistema de PowerShell. Al ejecutar estos comandos, PowerShell:
- Muestran un cuadro de diálogo que le pide el nombre de host o la dirección IP de la instancia.
- Mostrará el cuadro de diálogo Solicitud de credenciales de Windows PowerShell, que le solicita las credenciales. Puede usar el nombre de usuario y la contraseña de SQL para conectarse a su instancia de SQL Server en Linux.
- Use el cmdlet Get-SqlInstance para conectarse al servidor y mostrar algunas propiedades
Opcionalmente, puede reemplazar la variable $serverInstance por la dirección IP o el nombre de host de la instancia de SQL Server.
# 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 get a few properties
Get-SqlInstance -ServerInstance $serverInstance -Credential $credential
# done
PowerShell debe mostrar información similar al siguiente resultado:
Instance Name Version ProductLevel UpdateLevel HostPlatform HostDistribution
------------- ------- ------------ ----------- ------------ ----------------
your_server_instance 14.0.3048 RTM CU13 Linux Ubuntu
Nota:
Si no se muestra nada para estos valores, lo más probable es que se produzca un error en la conexión con la instancia de SQL Server de destino. Asegúrese de que puede usar la misma información de conexión para conectarse desde SQL Server Management Studio. Luego revise las recomendaciones para solucionar problemas de conexión.
Use el proveedor de SQL Server PowerShell
Otra opción para conectarse a la instancia de SQL Server es usar el proveedor de SQL Server PowerShell. Este proveedor permite navegar por la instancia de SQL Server de forma similar que si estuviera navegando por la estructura de árbol en el Explorador de objetos, pero en el cmdline. De forma predeterminada, este proveedor se presenta como un PSDrive denominado SQLSERVER:\ que puede usar para conectarse a instancias de SQL Server a las que tiene acceso su cuenta de dominio, y navegar por ellas. Para más información sobre cómo configurar la autenticación de Active Directory para SQL Server en Linux, consulte Pasos de configuración.
También puede usar la autenticación de SQL con el proveedor de SQL Server PowerShell. Para ello, use el cmdlet New-PSDrive para crear un nuevo PSDrive y proporcione las credenciales adecuadas para conectarse.
En este ejemplo, verá cómo crear un PSDrive mediante la autenticación de 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
Puede confirmar que la unidad se ha creado mediante la ejecución del cmdlet Get-PSDrive.
Get-PSDrive
Una vez que haya creado el PSDrive, puede empezar a navegar por él.
dir SQLonDocker:\Databases
Este es el aspecto que podría tener el resultado: Es posible que observe que el resultado es similar al que mostrará SQL Server Management Studio en el nodo de bases de datos. Muestra las bases de datos de usuario, pero no las bases de datos del sistema.
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
Si necesita ver todas las bases de datos en la instancia, una opción es usar el cmdlet Get-SqlDatabase.
Examinar registros de errores de SQL Server
En los pasos siguientes se usa PowerShell en Windows para examinar los registros de errores que se conectan a la instancia de SQL Server en Linux. También usaremos el cmdlet Out-GridView para mostrar información de los registros de errores en una vista de cuadrícula.
Copie y pegue los siguientes comandos en el símbolo del sistema de PowerShell. La ejecución puede tardar unos minutos. Estos comandos hacen lo siguiente:
- Muestran un cuadro de diálogo que le pide el nombre de host o la dirección IP de la instancia.
- Mostrará el cuadro de diálogo Solicitud de credenciales de Windows PowerShell, que le solicita las credenciales. Puede usar el nombre de usuario y la contraseña de SQL para conectarse a su instancia de SQL Server en Linux.
- Usan el cmdlet Get-SqlErrorLog para conectarse a la instancia de SQL Server en Linux y recuperar los registros de errores desde ayer.
- Canalizar el resultado al cmdlet Out-GridView
Opcionalmente, puede reemplazar la variable $serverInstance por la dirección IP o el nombre de host de la instancia de SQL Server.
# 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 | Out-GridView
# done