M00 — Setup da conta Azure + CLI

Duração: 1h Pré-requisitos: e-mail pessoal, cartão de crédito (validação), Windows com PowerShell. Objetivo: ter ambiente Azure pronto para criar recursos via portal e via linha de comando.

Por que este módulo

Sem conta ativa e sem az na sua máquina, todo o resto trava. E pior: você fica refém do portal (lento, esquece o que clicou). Engenheiro de dados precisa de CLI.

Parte 1 — Criar conta Azure free tier

Passo 1.1 — Cadastro

Acesse https://azure.microsoft.com/free.
Clique em “Comece grátis” / “Start free”.
Use uma conta Microsoft pessoal (Hotmail, Outlook, ou crie uma).
Informe celular (SMS) + cartão de crédito.

O que você ganha:

USD 200 em créditos para usar em 30 dias (vai dar e sobrar pra trilha).
12 meses grátis em ~25 serviços (inclui 5 GB de Blob Storage).
Acesso permanente a serviços “always free” (functions, cosmos limitado, etc.).

O que NÃO acontece:

Não cobra automaticamente quando o crédito acaba. A conta vira “pay-as-you-go” só se você confirmar upgrade.

Passo 1.2 — Validar acesso ao portal

Acesse https://portal.azure.com.
Confirme que aparece o dashboard com a subscription “Azure subscription 1” ou similar.
Anote o Subscription ID: Subscriptions → clica na que aparece → copia o ID.

Parte 2 — Instalar Azure CLI no Windows

Passo 2.1 — Instalar via winget (recomendado)

Abra PowerShell como Administrador e rode:

winget install -e --id Microsoft.AzureCLI

Se winget não estiver disponível, baixe o MSI: https://aka.ms/installazurecliwindows

Passo 2.2 — Validar instalação

Feche e reabra o PowerShell (não como admin). Rode:

az --version

Saída esperada (versão pode variar):

azure-cli                         2.60.0
core                              2.60.0
telemetry                          1.1.0

Passo 2.3 — Autenticar

az login

Vai abrir o navegador. Faça login com a conta da Azure. De volta no terminal, você verá uma lista JSON com sua subscription. Confirme que está usando a certa:

az account show --output table

Saída:

Name                  CloudName    SubscriptionId                        State    IsDefault
--------------------  -----------  ------------------------------------  -------  ---------
Azure subscription 1  AzureCloud   xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx  Enabled  True

Se você tem mais de uma subscription:

az account list --output table
az account set --subscription "<nome ou id>"

Parte 3 — Instalar Databricks CLI (usado a partir de M03)

winget install Databricks.DatabricksCLI

Validar:

databricks --version

A configuração (databricks configure) você faz no M03, depois de criar o workspace.

Parte 4 — VS Code + extensões úteis

Se ainda não tem, instala:

winget install -e --id Microsoft.VisualStudioCode

Extensões recomendadas (instale uma a uma com Ctrl+P → ext install <id>):

ms-azuretools.vscode-azureresourcegroups — navega seus recursos Azure no VS Code.
databricks.databricks — extensão oficial do Databricks (deploy de notebooks, run remote).
ms-python.python — Python.
mtxr.sqltools — SQL.

Parte 5 — Convenção de nomes que você vai usar a trilha toda

Crie um arquivo na sua máquina (naming.md) e cole isso. Você vai consultar muito:

PROJETO    = de            (data-engineer)
INICIAIS   = w             (suas iniciais — substitua pela sua!)
AMBIENTE   = dev           (dev | hml | prd)
REGIAO     = brs           (brazilsouth)

RECURSOS                  TEMPLATE                       EXEMPLO
─────────────────────────────────────────────────────────────────────
Resource Group            rg-<proj>-<amb>-<reg>          rg-de-dev-brs
Storage Account           st<proj><iniciais><amb><reg>   stdewdevbrs       ← sem hífen, max 24 chars, minúsculo
Databricks Workspace      dbw-<proj>-<amb>-<reg>         dbw-de-dev-brs
Data Factory              adf-<proj>-<amb>-<reg>         adf-de-dev-brs
Key Vault                 kv-<proj>-<iniciais>-<amb>     kv-de-w-dev       ← global unique
Container ADLS            bronze | silver | gold         bronze
SQL Server                sql-<proj>-<amb>-<reg>         sql-de-dev-brs

Por que isso importa: nomes consistentes evitam que você caia em “qual era o nome do storage mesmo?” no meio de um pipeline.

Parte 6 — Validar tudo de uma vez

Rode estes comandos. Todos devem retornar sucesso:

# Azure CLI logado?
az account show --query "name" -o tsv

# Databricks CLI instalado?
databricks --version

# Provider Microsoft.Databricks registrado na sua subscription? (precisa pro M03)
az provider register --namespace Microsoft.Databricks
az provider show -n Microsoft.Databricks --query "registrationState" -o tsv
# esperado: Registered

# Provider Microsoft.DataFactory? (precisa pro M05)
az provider register --namespace Microsoft.DataFactory
az provider show -n Microsoft.DataFactory --query "registrationState" -o tsv
# esperado: Registered (pode levar 1-2 min após register)

Se algum provider ficar em Registering, espere 2 min e rode az provider show de novo.

Pegadinhas comuns

“Insufficient permissions” ao criar recurso: você é Owner da sua subscription pessoal, então não deve acontecer. Se acontecer, verifique se az account show está na sub correta.
az login abre navegador mas não fecha: use az login --use-device-code para autenticar via código.
Crédito free tier “sumiu”: vá em Cost Management + Billing → Subscriptions → veja o saldo. Demora algumas horas pra aparecer após cadastro.
Storage Account name “is not available”: nome de storage é global no Azure inteiro. Adicione mais iniciais (suas, ou data: stdew20260516).
Não confunda Subscription com Tenant: tenant = a “empresa” (no free tier, é você mesmo); subscription = a “conta de cobrança”. Você só vai usar Subscription ID.

Checklist de saída

Antes de ir para M01, confirme:

az account show retorna sua subscription corretamente.
databricks --version funciona.
Providers Microsoft.Databricks e Microsoft.DataFactory estão Registered.
VS Code aberto com extensão Azure instalada.
Você anotou seu Subscription ID num arquivo local (vai usar muito).
Você definiu suas iniciais (w neste guia → trocar pela sua) e gravou em naming.md.

→ M01 — Resource Group + Storage Account