PowerShell

PowerShell to powłoka i język skryptowy Microsoftu, szeroko wykorzystywany do automatyzacji administracji SQL Server.

PowerShell jako powłoka i język automatyzacji

PowerShell to powłoka systemowa i język skryptowy rozwijany przez firmę Microsoft. Współczesna wersja PowerShell, oznaczana jako PowerShell 7, jest oparta na środowisku .NET i może działać w systemach Windows, Linux oraz macOS. W środowisku Windows nadal dostępny jest także Windows PowerShell 5.1, związany z platformą .NET Framework. Obie odmiany mają podobną składnię poleceń, ale nie są identycznym środowiskiem wykonawczym, dlatego skrypt przygotowany dla jednej wersji może wymagać sprawdzenia w drugiej.

Charakterystyczną cechą PowerShell jest przekazywanie między poleceniami obiektów, a nie wyłącznie tekstu. Polecenie Get-Process zwraca obiekty opisujące procesy, które można filtrować za pomocą Where-Object, sortować przez Sort-Object i wybierać przy użyciu Select-Object. Wynik można również zapisać do pliku CSV poleceniem Export-Csv. Taki model ułatwia budowanie powtarzalnych procedur, ponieważ kolejne polecenia korzystają z właściwości i metod danych, zamiast analizować format tekstu wyświetlanego na ekranie.

Połączenie PowerShell z SQL Server

W przypadku SQL Server PowerShell może służyć do wykonywania poleceń administracyjnych, odczytywania informacji o instancji oraz automatyzowania czynności związanych z bazami danych. Dostęp do SQL Server może być realizowany przez moduł SqlServer, który udostępnia między innymi polecenia Invoke-Sqlcmd, Backup-SqlDatabase i Restore-SqlDatabase. Moduł należy zainstalować i załadować w środowisku, w którym ma działać skrypt. Sam PowerShell nie zastępuje silnika SQL Server; jest warstwą automatyzacji, która może wywoływać instrukcje T-SQL oraz korzystać z obiektów administracyjnych.

Polecenie Invoke-Sqlcmd pozwala przekazać do SQL Server zapytanie lub zawartość pliku z instrukcjami T-SQL. Przykładowo można odczytać nazwę bieżącej bazy, listę tabel albo wynik zapytania kontrolnego i zapisać go do obiektu PowerShell. Przy pracy z konkretną instancją trzeba jednoznacznie określić nazwę serwera i instancji, bazę danych oraz sposób uwierzytelniania. W środowisku Windows może być używane uwierzytelnianie zintegrowane, natomiast SQL Server obsługuje także logowanie za pomocą loginu i hasła, jeśli zostało skonfigurowane. Dane uwierzytelniające nie powinny być wpisywane bezpośrednio w treści skryptu.

Struktura skryptu i kontrola wykonania

Skrypt PowerShell przeznaczony do pracy z SQL Server powinien rozdzielać konfigurację połączenia, wykonanie polecenia oraz obsługę wyniku. Przydatne jest stosowanie parametrów, na przykład nazwy instancji, bazy danych i ścieżki pliku kopii zapasowej, zamiast umieszczania tych wartości w wielu miejscach. Funkcje pozwalają wydzielić powtarzalne operacje, takie jak sprawdzenie dostępności instancji, wykonanie zapytania kontrolnego albo zapis raportu. Instrukcje try, catch i finally umożliwiają odróżnienie poprawnego zakończenia od błędu połączenia, błędu składni T-SQL lub problemu z uprawnieniami do pliku.

Ważnym elementem jest sprawdzanie kodu wyjścia i faktycznej zawartości wyniku. Samo uruchomienie polecenia PowerShell nie zawsze oznacza, że operacja SQL Server zakończyła się zgodnie z założeniem. Skrypt może zweryfikować, czy zapytanie zwróciło oczekiwaną liczbę wierszy, czy kopia zapasowa została utworzona oraz czy wskazana ścieżka istnieje. Przy operacjach modyfikujących dane należy stosować właściwe uprawnienia i unikać budowania instrukcji SQL przez proste łączenie tekstu z niezweryfikowanymi wartościami. Parametry zapytań lub bezpieczne przekazywanie wartości ograniczają ryzyko błędnej interpretacji danych jako fragmentu polecenia.

Diagnostyka problemów z uruchamianiem poleceń

Nieprawidłowe działanie skryptu PowerShell współpracującego z SQL Server może wynikać z kilku niezależnych przyczyn. Należy sprawdzić, czy uruchomiona jest właściwa wersja PowerShell, czy moduł SqlServer jest dostępny oraz czy jego polecenia zostały załadowane. Kolejnym krokiem jest weryfikacja nazwy instancji, dostępności usługi SQL Server, portu używanego przez połączenie i metody uwierzytelniania. Błąd „command not found” lub „nie rozpoznano nazwy polecenia” wskazuje zwykle na brak modułu albo niewłaściwą sesję, natomiast błąd logowania dotyczy najczęściej konta, hasła, trybu uwierzytelniania lub uprawnień.

Podczas analizy warto uruchomić krótkie polecenie testowe, na przykład zapytanie zwracające nazwę serwera i wersję SQL Server, a następnie zapisać wynik oraz komunikat błędu. Trzeba odróżnić błąd PowerShell od błędu zwróconego przez SQL Server, ponieważ wymagają one innego sposobu postępowania. Problem z parserem skryptu, ścieżką pliku lub modułem rozwiązuje się po stronie środowiska PowerShell. Błąd składni T-SQL, brak tabeli albo niewystarczające uprawnienia wymagają sprawdzenia zapytania i konfiguracji SQL Server. Przy diagnostyce laptopa lub komputera PC można również zweryfikować instalację narzędzi, zmienne środowiskowe, politykę uruchamiania skryptów oraz dostępność wymaganych bibliotek, bez zmieniania konfiguracji w ciemno.