- sara.next
- Technologia
- Skrypty SQL: wartości zwracane i przykład
Technologia · Dokumentacja
Skrypty SQL: wartości zwracane i przykład
Skrypt Groovy nie wykonuje zapytań sam — zwraca instrukcje SQL, które sara.next uruchamia na skonfigurowanym połączeniu. Poniżej zasady i przykład dla Microsoft SQL Server.
- Groovy
- SQL
- Microsoft SQL Server
- przykład
Zasady
Co zwraca skrypt
| Skrypt | Wartość zwracana | Jak jest wykonywana |
|---|---|---|
| Implementacyjny (Create, Replace, Modify, Delete) | String — pojedyncza instrukcja SQL | Instrukcja jest wykonywana na połączeniu SQL aplikacji. |
| Implementacyjny — wiele instrukcji | List<String> — lista instrukcji SQL | Wszystkie instrukcje są wykonywane w jednej transakcji; przy błędzie następuje wycofanie. |
| Weryfikujący | String z zapytaniem SELECT | true, jeśli zapytanie zwróci co najmniej jeden wiersz; false, jeśli nie zwróci żadnego. |
Przykład
Pełny przykład: Microsoft SQL Server
Przykład zakłada rolę z dwoma wymiarami: DB_NAME (nazwa bazy) i DB_OPERATIONS (lista ról bazodanowych lub uprawnień rozdzielona przecinkami). Gdy wymiar nie ma wartości, skrypt przyjmuje wartości domyślne demo i db_datareader.
Skrypt Create
Skrypt tworzy login serwera, jeśli jeszcze nie istnieje, następnie użytkownika w bazie, a na końcu nadaje uprawnienia: wartości zaczynające się od db_ są traktowane jako role bazodanowe (ALTER ROLE … ADD MEMBER), pozostałe jako uprawnienia (GRANT).
String login = user.samAccountName
String dbName = dimensions["DB_NAME"] ?: "demo"
String operations = dimensions["DB_OPERATIONS"] ?: "db_datareader"
List<String> sqls = []
sqls << "IF NOT EXISTS (SELECT 1 FROM sys.server_principals WHERE name = '${login}') " +
"CREATE LOGIN [${login}] WITH PASSWORD = '<hasło tymczasowe>', " +
"CHECK_POLICY = ON, CHECK_EXPIRATION = OFF;"
sqls << "USE [${dbName}]; " +
"IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = '${login}') " +
" CREATE USER [${login}] FOR LOGIN [${login}];"
operations.split(",").each { op ->
String o = op.trim()
if (o.startsWith("db_")) {
sqls << "USE [${dbName}]; ALTER ROLE [${o}] ADD MEMBER [${login}];"
} else {
sqls << "USE [${dbName}]; GRANT ${o} TO [${login}];"
}
}
return sqls*.toString()WskazówkaW tym miejscu hasło tymczasowe zastąpiono symbolem <hasło tymczasowe>. Sposób nadawania hasła ustal zgodnie z polityką haseł swojej organizacji.
Skrypt Modify
Skrypt odczytuje poprzednie wartości wymiarów z request.oldAtar, a następnie:
- odbiera dotychczasowe role i uprawnienia w poprzedniej bazie,
- upewnia się, że użytkownik istnieje w nowej bazie,
- nadaje nowe role i uprawnienia.
Login poprzedniego użytkownika jest pobierany z bezpieczną nawigacją (oldUser?.samAccountName), a gdy go brak — przyjmowany jest login bieżącego użytkownika.
Skrypt Delete
Skrypt pobiera login z oldUser, a wartości wymiarów z request.oldAtar. Kolejno:
- odbiera role i uprawnienia w bazie,
- usuwa użytkownika bazy, jeśli nie ma on już członkostwa w żadnej roli,
- usuwa login serwera, jeśli nie ma on już użytkowników w żadnej z baz.
Skrypt Verify
Zapytanie sprawdza, czy użytkownik o loginie ze zmiennej login istnieje w bazie. Dla wniosku Delete wynik jest odwracany przez harmonogram.
String dbName = dimensions["DB_NAME"] ?: "demo"
return "SELECT 1 FROM [${dbName}].sys.database_principals WHERE name = '${login}'".toString()UwagaNie należy kopiować przykładowych interpolacji tekstowych do kodu produkcyjnego bez walidacji. Identyfikatory użytkowników, role i nazwy baz powinny pochodzić z dopuszczonych list wartości, a zapytania muszą być projektowane z uwzględnieniem ryzyka SQL injection i praw systemowych konta integracyjnego.
Czytaj dalej
Powiązane dokumenty
Przygotuj skrypty SQL z naszym zespołem
Dobierzemy zakres uprawnień konta integracyjnego i sprawdzimy skrypty na środowisku testowym.