SQL-adatbázis létrehozása a Microsoft Fabricben REST API-val
A következőre vonatkozik:✅ SQL-adatbázis a Microsoft Fabricben
A Fabric platform számos REST API-val rendelkezik, amelyek az erőforrások üzembe helyezésére és kezelésére használhatók. Ezek az API-k felhasználhatók Fabric SQL-adatbázisok üzembe helyezésére. Ez a cikk és a mintaszkript egy olyan alapszintű PowerShell-szkriptet mutat be, amely egy Fabric SQL-adatbázis üzembe helyezésére és az adatok hozzáadására használható.
Előfeltételek
- Meglévő hálókapacitásra van szüksége. Ha nem, indítsa el a Fabric próbaverzióját.
- Győződjön meg arról, hogy engedélyezi az SQL-adatbázist a Hálóban a Felügyeleti portál bérlői beállításaival.
- Hozzon létre egy új munkaterületet , vagy használjon egy meglévő Fabric-munkaterületet.
- SQL-adatbázis létrehozásához a munkaterület rendszergazdai vagy tagi szerepköreinek tagjának kell lennie.
- Telepítse az SQLCMD golang verzióját. A telepítéshez futtassa
winget install sqlcmd
a Windows rendszert. Más operációs rendszerekről lásd: aka.ms/go-sqlcmd. - Az Az PowerShell-modul. A telepítéshez futtassa
Install-Module az
a PowerShellben.
Új SQL-adatbázis létrehozása REST API-val
Ez a példaszkript a hitelesítő adatok kérésének aliasát Connect-AzAccount
használjaaz login
. Ezekkel a hitelesítő adatokkal szerez be egy hozzáférési jogkivonatot a REST API-hívásokhoz. Az SQLCMD a megadott fiók Connect-AzAccount
környezetét használja.
A szkript létrehoz egy adatbázist, amely a bejelentkezett felhasználó aliasával és dátumával van elnevezve. A REST API jelenleg nem ad vissza állapotot, ezért hurkot kell kapnunk, és ellenőrizni kell, hogy létre kell-e hozni az adatbázist. Az adatbázis létrehozása után az SQLCMD használatával létrehoz néhány objektumot, majd lekérdezi a létezését. Végül töröljük az adatbázist.
Az alábbi szkriptben cserélje le <your workspace id>
a Fabric-munkaterület azonosítóját.
A munkaterület azonosítóját könnyen megtalálhatja az URL-címben, ez a böngészőablakban két /
karakterből /groups/
álló egyedi sztring. Például a 11aa111-a11a-1111-1abc-aa1111aaaa
következőben: https://fabric.microsoft.com/groups/11aa111-a11a-1111-1abc-aa1111aaaa/
.
Ez a szkript a következőket mutatja be:
- Hozzáférési token lekérése a Get-AzAccessToken használatával, majd konvertálása egy biztonságos sztringből. PowerShell 7 használata esetén a ConvertFrom-SecureString is egy lehetőség.
- Hozzon létre egy új SQL-adatbázist az Items – Create Item APIhasználatával.
- A Fabric-munkaterület összes SQL-adatbázisának listázása.
- Csatlakozzon az adatbázishoz SQLCMD használatával, hogy szkriptet futtasson egy objektum létrehozásához.
- Törölje az adatbázist az Elemek – Elem törlése APIhasználatával.
Import-Module Az.Accounts
Connect-AzAccount
$workspaceid = '<your workspace id>'
$databaseid = $null
$headers = $null
$responseHeaders = $null
# 1. Get the access token and add it to the headers
$access_token = (Get-AzAccessToken -AsSecureString -ResourceUrl https://api.fabric.microsoft.com)
$ssPtr = [System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($access_token.Token)
try {
$headers = @{
Authorization = $access_token.Type + ' ' + ([System.Runtime.InteropServices.Marshal]::PtrToStringBSTR($ssPtr))
}
$access_token.UserId -match('^[^@]+') | Out-Null
# 2. Create the database and wait for it to be created.
$body = @{
displayName = $matches[0] + (Get-Date -Format "MMddyyyy")
type = "SQLDatabase"
description = "Created using public api"
}
$parameters = @{
Method="Post"
Headers=$headers
ContentType="application/json"
Body=($body | ConvertTo-Json)
Uri = 'https://api.fabric.microsoft.com/v1/workspaces/' + $workspaceid + '/items'
}
Invoke-RestMethod @parameters -ErrorAction Stop
$databases = (Invoke-RestMethod -Headers $headers -Uri https://api.fabric.microsoft.com/v1/workspaces/$($workspaceid)/SqlDatabases).value
$databaseid = $databases.Where({$_.displayName -eq $body.displayName}).id
While($databaseid -eq $null)
{
Write-Host 'Waiting on database create.'
Start-Sleep 30
$databases = (Invoke-RestMethod -Headers $headers -Uri https://api.fabric.microsoft.com/v1/workspaces/$($workspaceid)/SqlDatabases).value
$databaseid = $databases.Where({$_.displayName -eq $body.displayName}).id
}
# 3. List all SQL databases in a Fabric workspace
Write-Host 'Listing databases in workspace.'
Invoke-RestMethod -Headers $headers -Uri https://api.fabric.microsoft.com/v1/workspaces/$($workspaceid)/items?type=SQlDatabase | select -ExpandProperty Value | ft
$databaseProperties = (Invoke-RestMethod -Headers $headers -Uri https://api.fabric.microsoft.com/v1/workspaces/$($workspaceid)/SqlDatabases/$($databaseid) | select -ExpandProperty Properties)
#4. Connnect to the database and create a table
Write-Host 'Attempting to connect to the database.'
sqlcmd.exe -S $databaseProperties.ServerFqdn -d $databaseProperties.DatabaseName -G -Q 'create table test2
(
id int
)'
#5. Delete the database
$parameters = @{
Method="Delete"
Headers=$headers
ContentType="application/json"
Body=($body | ConvertTo-Json)
Uri = 'https://api.fabric.microsoft.com/v1/workspaces/' + $workspaceid + '/items/' + $databaseid
}
Invoke-RestMethod @parameters
Write-Output 'Cleaned up:' $body.displayName
} finally {
# The following lines ensure that sensitive data is not left in memory.
$headers = [System.Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ssPtr)
$parameters = [System.Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ssPtr)
}