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