Article: AN0001779Updated: 22.04.2020
Tato funkce vrátí seznam databází s danými vlastnostmi z SQL serverů dle konfigurace.
Hlavní předpoklady pro použití
Předpoklad |
Popis |
Powershell remoting |
Při komunikaci s externími systémy využívajícími vykonání Powershell příkazů externím systémem je třeba na externím systému povolit remoting. |
Master DB_datareader |
Pro vyčtení informací o databázích na SQL serveru je třeba účtu vykonávajícímu dotaz přidělit oprávnění na čtení těchto dat. |
Práva na službu WinRM |
Při komunikaci s externími systémy využívajícími vykonání Powershell příkazů externím systémem je třeba účtu odesílajícímu příkaz přidělit práva na remoting. |
Powershell v3 |
Microsoft Powershell verze 3 nebo vyšší. |
Popis
Funkce vytvoří textový soubor obsahující informace o databázích dle konfigurace. Soubor je v kódování UTF-8 a jako oddělovač používá tabulátor. Soubor obsahuje následující informace.
Název hlavičky sloupce |
Popis |
SQLServer |
Název serveru, na kterém se nachází SQL server. |
Domain |
Název domény tohoto serveru. |
InstanceName |
Název instance SQL serveru. |
IP |
IP adresa serveru. |
DBName |
Název databáze. |
Recovery model |
Recovery model databáze. |
Collation |
Kolace databáze. |
Last Database Backup (yyyy-mm-dd hh:mm:ss) |
Datum a čas poslední zálohy databáze. |
Last Database Log Backup (yyyy-mm-dd hh:mm:ss) |
Datum a čas poslední zálohy logu databáze. (U databáze v simple recovery režimu není log zálohován.) |
Size (GB) |
Čistá velikost databáze v GB (desetinné číslo). |
Space Available (MB) |
Velikost volného místa v databázi v GB (desetinné číslo). |
Compatibility level |
Kompatibility level databáze. |
Parametry
Níže uvedené parametry uveďte v souboru og_configuration.ps1 (obecné parametry sdílené s jinými funkcemi) nebo v souboru OG_SQL-DB.config (konkrétní parametry této funkce). Konfigurace parametrů je obecně popsána v dokumentaci programu Piklo.
Parametr |
Popis |
Příklad |
[string]$WebServer |
Adresa webové služby obsahující třídu se seznamem SQL serverů, z nichž mají být vyčteny informace o databázích. |
[string]$WebServer = "https://yourserver.yourdomain.com/OGService.asmx?WSDL" |
[string]$filterModelCode |
Kód modelu obsahující třídu se seznamem SQL serverů, z nichž mají být vyčteny informace o databázích. |
[string]$filterModelCode = "mon-and-man"
|
[string]$filterParentCode |
Kód třídy se seznamem SQL serverů, z nichž mají být vyčteny informace o databázích. |
[string]$filterParentCode = "server-sqldb"
|
[int]$AttrKey_Server |
Id sloupce s názvy serverů. |
[int]$AttrKey_Server = 6155
|
[int]$AttrKey_Domain |
Id sloupce s názvem domény serveru. |
[int]$AttrKey_Domain = 6156
|
[int]$AttrKey_Instance |
Id sloupce s názvem instance. |
[int]$AttrKey_Instance = 6157
|
[int]$AttrKey_Aktivni |
Id sloupce udávajícího, zda z daného serveru mají být vyčteny informace o databázích. Lze použít pro dočasné vyřazení určitého serveru ze sběru informací. |
[int]$AttrKey_Aktivni = 6158
|
[int]$AttrKey_MSSqlServerServiceName |
Id sloupce s názvem služby SQL serveru. |
[int]$AttrKey_MSSqlServerServiceName = 6161
|
[string]$ExportFile |
Cesta k souboru, v němž má být uložen výstup funkcionality. |
[string]$ExportFile = "\\yourserver\data\OG-output\SQL-DB.txt"
|
[string]$LogFile |
Cesta k souboru, v němž má být uložen log funkcionality. |
[string]$LogFile = "\\yourserver\data\OG-output\SQL-DB_Log.txt"
|
Volání
Funkce je volána pomocí programu Piklo, který je součástí balíku ObjectGears, ze skriptu ObjectGears. Výsledek volání je třeba přiřadit do proměnné, se kterou lze ve skriptu dále pracovat.
a = OG.Process.RunPiklo('OG_SQL-DB','-type C')