Partilhar via

Criar um banco de dados SQL no Microsoft Fabric por meio da API REST

  • Artigo

Aplica-se a:✅Banco de dados SQL no Microsoft Fabric

A plataforma Fabric tem um conjunto avançado de APIs REST que podem ser usadas para implantar e gerenciar recursos. Essas APIs podem ser usadas para implantar bancos de dados SQL de malha. Este artigo e o script de exemplo demonstram um script básico do PowerShell que pode ser usado para implantar um banco de dados SQL de malha e adicionar dados a ele.

Pré-requisitos

Criar um novo banco de dados SQL via API REST

Este script de exemplo usa Connect-AzAccount, um alias de az login para solicitar credenciais. Em seguida, ele usa as credenciais para obter um token de acesso que será usado para as chamadas da API REST. SQLCMD usa o contexto da conta que foi dada ao Connect-AzAccount.

O script cria um banco de dados nomeado com o alias do usuário conectado e a data. Atualmente, a API REST não retorna um status, então devemos fazer loop e verificar se o banco de dados será criado. Depois que o banco de dados é criado, o SQLCMD é usado para criar alguns objetos e, em seguida, consultar sua existência. Finalmente, eliminamos a base de dados.

No script a seguir, substitua <your workspace id> pela ID do espaço de trabalho Malha. Você pode encontrar o ID de um espaço de trabalho facilmente no URL, é a cadeia de caracteres exclusiva dentro de dois / caracteres depois /groups/ na janela do navegador. Por exemplo, 11aa111-a11a-1111-1abc-aa1111aaaa em https://fabric.microsoft.com/groups/11aa111-a11a-1111-1abc-aa1111aaaa/.

Import-Module Az 
Connect-AzAccount 
$access_token = (Get-AzAccessToken -ResourceUrl https://analysis.windows.net/powerbi/api) 
$headers = @{ 
   Authorization = $access_token.Type + ' ' + $access_token.Token 
   } 
$workspaceid = '<your workspace id>' 
$databaseid = $null 
$responseHeaders = $null 
$access_token.UserId -match('^[^@]+') | Out-Null 
$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 
   }

Agora, liste os bancos de dados no espaço de trabalho para ver o novo banco de dados SQL.

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)

Você também pode executar scripts de instruções T-sQL por meio de chamadas de API SQLCMD e REST. Neste próximo script de exemplo, criaremos algumas tabelas.

Write-Host '...Creating a table.' 

# this script requires the golang version of SQLCMD. Run 'winget install sqlcmd' on a Windows desktop to install. For other operating systems, visit aka.ms/go-sqlcmd 

sqlcmd.exe -S $databaseProperties.ServerFqdn -d $databaseProperties.DatabaseName -G -Q 'create table test2 
   ( 
   id int 
   )' 

Write-Host '...Query sys.tables to confirm create.' 

sqlcmd.exe -S $databaseProperties.ServerFqdn -d $databaseProperties.DatabaseName -G -Q 'SELECT * FROM sys.tables' 

Invoke-RestMethod -Headers $headers -Uri https://api.fabric.microsoft.com/v1/workspaces/$($workspaceid)/items?type=SQlDatabase | select -ExpandProperty Value | ft

Clean up resources (Limpar recursos)

Opcionalmente, você também pode excluir o banco de dados usando uma chamada de API REST.

Write-Host 'Deleting 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 'Deleted database.'

Conteúdos relacionados