New presentation - Backup Basics with Powershell and dbatools

andy-levy/BackupBasics/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "jupyter.jupyterServerType": "local"
+}

andy-levy/BackupBasics/00_Before_Starting.ps1

@@ -0,0 +1,10 @@
+<#
+Do this before starting new session
+#>
+Clear-Host;
+Remove-DbaDatabase -SqlInstance flexo\sql17 -database stackoverflow2010 -confirm:$false;
+Remove-Item -force -Path 'C:\SQL\Backup\FLEXO$SQL17\StackOverflow2010' -recurse -confirm:$false;
+Restore-DbaDatabase -SqlInstance FLEXO\sql17 -DatabaseName StackOverflow2010 -ReplaceDbNameInFile -WithReplace -Path C:\Datasets\StackOverflow2010.bak;
+Invoke-DbaQuery -SqlInstance FLEXO\sql17 -Database msdb -Query "exec sp_delete_database_backuphistory @database_name='StackOverflow2010';";
+Start-DbaAgentJob -SqlInstance FLEXO\sql17 -Job "DatabaseBackup - USER_DATABASES - FULL" -Wait;
+Start-DbaAgentJob -SqlInstance FLEXO\sql17 -Job "DatabaseBackup - USER_DATABASES - Log" -Wait;

andy-levy/BackupBasics/00_Why_Azure_Data_Studio.ipynb

@@ -0,0 +1,38 @@
+{
+    "metadata": {
+        "kernelspec": {
+            "name": "SQL",
+            "display_name": "SQL",
+            "language": "sql"
+        },
+        "language_info": {
+            "name": "sql",
+            "version": ""
+        },
+        "extensions": {
+            "azuredatastudio": {
+                "version": 1,
+                "views": []
+            }
+        }
+    },
+    "nbformat_minor": 2,
+    "nbformat": 4,
+    "cells": [
+        {
+            "cell_type": "markdown",
+            "source": [
+                "# Why Azure Data Studio?\r\n",
+                "\r\n",
+                "With Azure Data Studio, we can mix text (in Markdown form), code, and the code's output, into a single package.\r\n",
+                "\r\n",
+                "We can then hand that package to someone else, ask them to run it, save the results, and send it back.\r\n",
+                "\r\n",
+                "This lets us keep the code nicely organized with the output, and intersperse instructions and other documentation."
+            ],
+            "metadata": {
+                "azdata_cell_guid": "c5ce23b2-0603-47b4-9f4d-c63b228e2883"
+            }
+        }
+    ]
+}

andy-levy/BackupBasics/01_Installation.ps1

@@ -0,0 +1,23 @@
+Clear-Host;
+<#
+Installation & Maintenance
+
+Check for an existing dbatools module installation
+#>
+Get-Module -ListAvailable -Name dbatools;
+
+<#
+Trust the PowerShell Gallery
+#>
+Set-PSRepository -Name PSGallery -InstallationPolicy Trusted;
+
+<#
+Update the existing module or install if it's not there
+#>
+
+if (Get-Module -ListAvailable -Name dbatools) {
+    Update-Module -Name dbatools -Verbose;
+}
+else {
+    Install-Module -Name dbatools -Scope CurrentUser -Verbose;
+}

andy-levy/BackupBasics/02_Conventions.ps1

@@ -0,0 +1,39 @@
+Clear-Host;
+<#
+# Conventions
+## Getting Help
+Every dbatools function has extensive comment-based help accessible via `Get-Help`. This help is also available at https://docs.dbatools.io/
+
+`Find-DbaCommand <searchterm>` is your friend! Use this function to locate functions related to what you need to do.
+#>
+$BackupFunctions = Find-DbaCommand -Pattern backup;
+
+$BackupFunctions.Count;
+
+$BackupFunctions;
+
+<#
+## Naming Conventions
+
+* dbatools follows standard Powershell function naming conventions
+  * All dbatools function names follow the convention `Verb-DbaNoun`
+  * Most `Get`s have a corresponding `Set`
+* Functions with `Db` in their name _usually_ want to operate on the database level, not the whole instance.
+#>
+<#
+## Splatting
+
+Variable splatting is a method in Powershell where we can pass a collection of parameters to a function. This makes it easier to:
+* Read without scrolling horizontally
+* Dynamically change the parameter list passed to a function
+For more information, see [`get-help about_splatting`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_splatting?view=powershell-7.1)
+
+When using splatting with switch parameters, you must explicitly state `$true` or `$false` for the switch value. For example, `-Verbose` becomes `Verbose = $true;`
+#>
+
+$BackupParams = @{
+    SqlInstance  = "FLEXO\sql17";
+    Path         = $BackupPath;
+    Database     = "satellites";
+    CreateFolder = $true;
+}

andy-levy/BackupBasics/03_Instance_Objects.ps1

@@ -0,0 +1,43 @@
+clear-host;
+<#
+# Instance-level Objects
+## Keys & Certificates
+### Functions Demonstrated
+* `Backup-DbaServiceMasterKey`
+* `Backup-DbaDbMasterKey`
+* `Backup-DbaDbCertificate`
+
+### Service Master Key
+#>
+
+$KeyBackupPassword = "MyP@$$w3rd" | ConvertTo-SecureString -AsPlainText -Force;
+$KeyBackupParams = @{
+    SqlInstance = "FLEXO\sql17";
+    Path        = "C:\SQL\Backup";
+    Password    = $KeyBackupPassword;
+};
+Backup-DbaServiceMasterKey @KeyBackupParams;
+
+<#
+### Database Master Key
+#>
+
+$KeyBackupParams += @{
+    Database = "master";
+};
+
+Backup-DbaDbMasterKey @KeyBackupParams;
+
+<#
+### Certificates
+#>
+$CertBackupParams = @{
+    SqlInstance        = "FLEXO\sql17";
+    Path               = "C:\SQL\Backup";
+    EncryptionPassword = "My0th3rP@ssw0rD" | ConvertTo-SecureString -AsPlainText -Force;
+    DecryptionPassword = "bathrobe.rifleman.resent.demit" | ConvertTo-SecureString -AsPlainText -Force; # This is the password you set when creating the certificate
+    Database           = "master";
+    Certificate        = "TDECert_2021";
+};
+
+Backup-DbaDbCertificate @CertBackupParams;

andy-levy/BackupBasics/04_Basic_Backup_Restore.ps1

@@ -0,0 +1,114 @@
+Clear-Host;
+<#
+# Database Backup
+## Basic Backup
+### Function Demonstrated
+* `Backup-DbaDatabase`
+#>
+$BackupPath = "C:\SQL\Backup\";
+$BackupParams = @{
+    SqlInstance  = "FLEXO\sql17";
+    Path         = $BackupPath;
+    Database     = "satellites";
+    CreateFolder = $true;
+}
+$BackupResult = Backup-DbaDatabase @BackupParams;
+
+$BackupResult | Format-List -Property *;
+
+# Save this for later
+$SingleBackupFile = $BackupResult.BackupPath;
+
+
+<#
+Let's go a bit more complex
+- Copy-only
+- Multiple files
+- Compression
+- Checksum & Verify
+- Custom timestamp format
+- Adjust `MaxTransferSize` and `BufferCount`
+
+See https://sirsql.net/2012/12/13/20121212automated-backup-tuning/ for scripts to test your own backup performance
+#>
+$BackupParams += @{
+    CopyOnly        = $true;
+    Type            = "Full";
+    FileCount       = 4;
+    CompressBackup  = $true;
+    Checksum        = $true;
+    Verify          = $true;
+    BufferCount     = 1000;
+    MaxTransfersize = 2 * 1MB;
+    TimeStampFormat = "yyyy-MMM-dd HH.mm.ss";
+}
+$BackupResult = Backup-DbaDatabase @BackupParams;
+
+$BackupResult | Format-List -Property *;
+
+<#
+What are we running?
+
+The -OutputScriptOnly switch parameter tells -Backup-DbaDatabase to not perform the backup but instead show the T-SQL to execute the backup.
+#>
+$BackupParams += @{
+    OutputScriptOnly = $true;
+}
+
+Backup-DbaDatabase @BackupParams | Set-Clipboard;
+<#
+
+#>
+
+<#
+## Restoring the Latest Backup
+* The `-Path` parameter specifies a path to search for backups. If multiple backups are found, the most recent one will be used.
+* `-Database` is the name the database will have when restored, not the original name of the database when it was backed up.
+
+### Function Demonstrated
+* `Restore-DbaDatabase`
+#>
+Clear-Host;
+$RestoreParams = @{
+    SqlInstance = "FLEXO\sql19";
+    Path        = "C:\SQL\Backup\Satellites";
+    Database    = "Satellites19";
+}
+$RestoreResult = Restore-DbaDatabase @RestoreParams;
+
+$RestoreResult | Format-List -Property *;
+
+<#
+## Restoring a Specific Backup
+If the database name we're restoring to already exists, `-WithReplace` will overwrite it. **Use with caution!**
+
+### Function Demonstrated
+* `Set-DbaDbOwner`
+#>
+$RestoreParams["Path"] = $SingleBackupFile;
+$RestoreParams += @{
+    WithReplace = $true;
+}
+$RestoreResult = Restore-DbaDatabase @RestoreParams;
+
+$RestoreResult | Format-List -Property *;
+
+Set-DbaDbOwner -SqlInstance FLEXO\sql19 -Database Satellites19 -TargetLogin sa;
+
+<#
+## Just Looking!
+
+Maybe I'm just looking to learn how to construct a `RESTORE DATABASE` SQL statement. Other times, I just want to review the statement before it's executed.
+
+The `-ReplaceDbNameInFile` renames the pysical files to match the database name when restored.
+#>
+
+$RestoreParams += @{
+    OutputScriptOnly    = $true;
+    ReplaceDbNameInFile = $true;
+}
+
+Restore-DbaDatabase @RestoreParams | Set-Clipboard;
+<#
+
+#>

andy-levy/BackupBasics/05_Point_In_Time_Restore.ps1

@@ -0,0 +1,67 @@
+Clear-Host;
+<#
+# Point In Time Restore
+Who hasn't accidentally dropped a table?
+
+## Function Demonstrated:
+* `Invoke-DbaQuery`
+#>
+
+$PreUpdateTime = Get-Date;
+$SOUpdateParams = @{
+    SqlInstance = "FLEXO\sql17";
+    Database    = "StackOverflow2010";
+    Query       = "drop table [Users];";
+}
+Invoke-DbaQuery @SOUpdateParams;
+
+<#
+Let's restore the database so we can fix the data
+
+Take a log backup so we have something to work with
+#>
+Start-DbaAgentJob -SqlInstance FLEXO\sql17 -Job "DatabaseBackup - USER_DATABASES - Log" -Wait;
+
+<#
+Now we'll restore the database to a new one to use as a reference
+#>
+$RestoreParams = @{
+    SqlInstance                = "FLEXO\sql17";
+    Path                       = 'C:\sql\Backup\FLEXO$SQL17\StackOverflow2010\';
+    DatabaseName               = "StackOverflow2010";
+    RestoredDatabaseNamePrefix = "Restored";
+    RestoreTime                = $PreUpdateTime;
+    ReplaceDbNameInFile        = $true;
+    MaintenanceSolutionBackup  = $true;
+    WithReplace                = $true;
+}
+$RestoreResult = Restore-DbaDatabase @RestoreParams;
+
+$RestoreResult | Format-List -Property *;
+
+$RestoredDBName = $RestoreResult[-1].Database;
+
+<#
+Database is restored, let's verify the table is there
+#>
+
+$SOQueryParams = @{
+    SqlInstance = "FLEXO\sql17";
+    Database    = "StackOverflow2010";
+    Query       = "select count(*) as UserCount from [Users];"
+}
+
+Invoke-DbaQuery @SOQueryParams | Format-Table -AutoSize;
+
+$SOQueryParams["Database"] = $RestoredDBName;
+Invoke-DbaQuery @SOQueryParams | Format-Table -AutoSize;
+
+<#
+## Cleanup
+
+Data looks good in the restored database, so we'll fix things up in the live database using that data (not shown), then remove the restored database.
+## Function Demonstrated:
+* `Remove-DbaDatabase`
+#>
+
+Remove-DbaDatabase -SqlInstance FLEXO\SQL17 -Database $RestoredDBName;

andy-levy/BackupBasics/06_Backup_Setup.ps1

@@ -0,0 +1,21 @@
+Clear-Host;
+<#
+# Basic Backup Setup
+## Where do backups go?
+### Function Demonstrated
+* `Get-DbaDefaultPath`
+#>
+
+Get-DbaDefaultPath -SqlInstance FLEXO\Sql17;
+
+Get-DbaDefaultPath -SqlInstance FLEXO\Sql17,FLEXO\Sql19 | Select-Object ComputerName,ErrorLog;
+
+<#
+## Check & Set Backup Compression
+### Functions Demonstrated
+* `Get-DbaSpConfigure`
+* `Set-DbaSpConfigure`
+#>
+
+Get-DbaSpConfigure -SqlInstance FLEXO\Sql17 -Name DefaultBackupCompression;
+Set-DbaSpConfigure -SqlInstance FLEXO\Sql17 -Name DefaultBackupCompression -Value 1;