Como criar um Template de Exportação CSV em Copilot no Fabric
Este tutorial mostra como criar um Template de Exportação CSV no Copilot do Fabric para transformar e exportar uma tabela como ficheiro CSV pronto a descarregar. É útil para automatizar relatórios, partilha de dados e integração com sistemas que exigem CSV.
Pré-requisitos
- Conta com acesso ao Microsoft Fabric e permissões para usar o Copilot no workspace.
- Tabela ou dataset disponível no Lakehouse ou Warehouse com dados de exemplo.
- Noções básicas de prompts e do ambiente do Copilot no Fabric.
Passo 1: Abrir o Copilot no Fabric e descrever o objetivo
Abre o Copilot no Fabric no workspace onde está a tabela. No prompt inicial descreve claramente que pretendes um Template que gere um CSV a partir de uma tabela, indicando o nome da tabela, as colunas a incluir e as regras de formatação (por exemplo separador, formato de data, tratamento de nulos).
Exemplo de prompt:
"Cria um Template chamado 'ExportCSV_Sales' que exporta a tabela Sales.Lakehouse.SalesData para CSV. Incluir colunas: Date, CustomerID, Amount. Separador ';'. Formatar Date como YYYY-MM-DD. Substituir NULL por vazio. Gerar comando para download e instruções para automatização."
Passo 2: Ajustar o Template para tratar dados (limpeza e transformações)
O Copilot vai sugerir um Template com passos de transformação. Revê e pede modificações: normalizar datas, remover espaços, converter tipos e filtrar linhas. Pede explicitamente exemplos de transformação e inclui um pequeno código se necessário (SQL/KQL/Python) para o ambiente onde a tabela está.
Exemplo de transformação em SQL (Warehouse):
SELECT
FORMAT(Date,'yyyy-MM-dd') AS Date,
TRIM(CustomerID) AS CustomerID,
CAST(Amount AS DECIMAL(18,2)) AS Amount
FROM Sales.Lakehouse.SalesData
WHERE Amount IS NOT NULL;
Passo 3: Gerar o passo de exportação para CSV
Pede ao Copilot que adicione o passo final que converte o resultado em CSV com o separador escolhido e que trate valores nulos. Dependendo do ambiente, pode gerar um comando de exportação direto (por ex. em Dataflow, Notebook ou script SQL). Valida que o Template inclui opções para nome do ficheiro e local de armazenamento.
Exemplo para Notebook (PySpark) que cria CSV no Lakehouse path:
df = spark.sql("SELECT FORMAT(Date,'yyyy-MM-dd') AS Date, TRIM(CustomerID) AS CustomerID, CAST(Amount AS DECIMAL(18,2)) AS Amount FROM Sales.Lakehouse.SalesData WHERE Amount IS NOT NULL")
df = df.fillna('')
df.coalesce(1).write.option('sep',';').option('header','true').csv('/lakehouse/exports/ExportCSV_Sales')
# O Copilot pode sugerir comandos adicionais para mover/renomear o ficheiro de output
Passo 4: Adicionar metadados e parâmetros ao Template
Para reutilização, pede ao Copilot que transforme o Template em parametrizável: permitir selecionar intervalo de datas, colunas opcionais, nome do ficheiro e separador. Valida que os parâmetros têm valores por omissão e instruções de uso no próprio Template.
Exemplo de estrutura de parâmetros (pseudo):
params = {
'start_date': '2026-01-01',
'end_date': '2026-12-31',
'columns': ['Date','CustomerID','Amount'],
'separator': ';',
'output_path': '/lakehouse/exports/ExportCSV_Sales'
}
# O Template usa params para construir a query e o ficheiro CSV
Passo 5: Testar o Template com o Copilot (execução e iteração)
Executa o Template com um subconjunto de dados para validar transformações e formato CSV. Se o resultado tiver problemas (delimitadores errados, datas mal formatadas, colunas em falta), pede ao Copilot para iterar e corrigi-los. Guarda versões do Template com comentários sobre alterações.
Sequência de testes recomendada:
1) Executar com parâmetros de teste (pequeno intervalo de datas).
2) Abrir o CSV gerado para validar separador e cabeçalho.
3) Corrigir transformações e repetir.
Verificar o resultado
Confirma que o CSV contém o cabeçalho correto, o separador é ';', as datas estão em YYYY-MM-DD, não há valores 'NULL' e os valores numéricos têm duas casas decimais. Verifica também que o ficheiro está acessível no caminho indicado e que o Template aceita parâmetros e gera de forma consistente o mesmo formato.
Conclusão
Agora tens um Template de Exportação CSV no Copilot do Fabric reutilizável e parametrizável para automatizar exportações de dados. Próximos passos: integrar o Template num fluxo de automatização/ETL ou criar um botão no Power BI para disparar a exportação. Dica: guarda sempre exemplos de entrada e saída para facilitar a validação futura — qual é o primeiro ficheiro que vais exportar com este Template?