Carregando
0x70Lição 8 de 25

CSV, JSON e formatação

Importe e exporte CSV e JSON, modele objetos com propriedades calculadas e formate a saída para pessoas.

28 min Questionário com 7 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • Leia e escreva CSV com Import-Csv, Export-Csv e seus primos ConvertFrom/ConvertTo
  • Converta objetos de e para JSON e evite armadilhas de profundidade e de item único
  • Adicione propriedades calculadas com Select-Object e formate a saída com Format-Table e Format-List

Como o PowerShell funciona com objetos, a conversão entre arquivos e dados é um comando em cada sentido:

FormatoLeiaEscreva
Arquivo CSVImport-Csv dragons.csvExport-Csv dragons.csv -NoTypeInformation
Texto CSVConvertFrom-CsvConvertTo-Csv
Texto JSONConvertFrom-JsonConvertTo-Json
JSON de uma API webInvoke-RestMethod https://...
Formato próprio do PowerShellImport-ClixmlExport-Clixml (mantém tipos)

-NoTypeInformation é o padrão no PowerShell 7; O Windows PowerShell 5.1 adiciona uma linha #TYPE extra sem ela. Lembre-se: tudo o que sai de um CSV é uma string.

csv-and-json.ps1
1$dragons = @'
2Name,Wingspan
3Ember,12
4Glim,2
5'@ | ConvertFrom-Csv
6$dragons[0].Wingspan.GetType().Name
7$dragons | ConvertTo-Json -Compress
8$feeding = '{"keeper":"Ada","meals":[{"dragon":"Ember","kg":40},{"dragon":"Glim","kg":1}]}' | ConvertFrom-Json
9$feeding.keeper
10($feeding.meals | Measure-Object -Property kg -Sum).Sum
11$feeding.meals[0].dragon
Saída
String
[{"Name":"Ember","Wingspan":"12"},{"Name":"Glim","Wingspan":"2"}]
Ada
41
Ember

ConvertFrom-Json fornece objetos com números reais e arrays aninhadas - pontilhando-os diretamente. Chamar uma API web funciona da mesma maneira: Invoke-RestMethod busca e converte em uma única etapa:

$weather = Invoke-RestMethod "https://api.example.com/forecast?city=Emberfall"
$weather.daily | Where-Object { $_.rain -gt 5 } | Select-Object date, rain

Propriedades calculadas

Select-Object pode inventar propriedades. Em vez de um nome de propriedade, forneça uma tabela hash com um bloco de script Name e Expression. É assim que você corrige tipos, renomeia colunas e adiciona valores computados antes de exportar:

calculated.ps1
1$dragons = @'
2Name,Wingspan,Age
3Ember,12,140
4Glim,2,12
5Skyla,15,88
6'@ | ConvertFrom-Csv
7$dragons |
8  Select-Object Name,
9    @{ Name = 'Wingspan'; Expression = { [int]$_.Wingspan } },
10    @{ Name = 'Category'; Expression = { if ([int]$_.Age -ge 100) { 'elder' } else { 'young' } } } |
11  ConvertTo-Csv -NoTypeInformation
Saída
"Name","Wingspan","Category"
"Ember","12","elder"
"Glim","2","young"
"Skyla","15","young"

Formatação para pessoas

Quando os objetos chegam ao final do pipeline, o PowerShell escolhe uma visualização: uma tabela para até quatro propriedades, uma lista para mais. Você pode escolher:

  • Format-Table Name, Wingspan -AutoSize - colunas, dimensionadas para caber
  • Format-List * - uma propriedade por linha, todas propriedades
  • Out-String - o texto formatado como uma string

Os cmdlets Format-* produzem instruções de exibição, não dados - e é por isso que eles sempre vão por último. $x | Format-Table | Export-Csv grava lixo.

format.ps1
1$ember = [pscustomobject]@{ Name = 'Ember'; Species = 'Firedrake'; Wingspan = 12 }
2$glim = [pscustomobject]@{ Name = 'Glim'; Species = 'Wisp'; Wingspan = 2 }
3$ember, $glim | Format-Table Name, Wingspan
4$ember | Format-List
Saída

Name  Wingspan
----  --------
Ember       12
Glim         2


Name     : Ember
Species  : Firedrake
Wingspan : 12

Principais conclusões

  • Import-Csv/ConvertFrom-Csv e ConvertFrom-Json transformam texto em objetos; Export-Csv e ConvertTo-Json voltam.

  • Os valores CSV são strings; JSON mantém números. Use -Depth e @( ) com ConvertTo-Json.

  • Propriedades calculadas, @{ Name = ...; Expression = { ... } }, remodelam objetos em Select-Object.

  • Format-Table e Format-List são apenas para exibição - sempre por último.

Quiz da aula

7 perguntas · aprovação com 5 acertos · até 50 XP

Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.

Pratique: escreva código em scripts PowerShell

Escreva um script no editor e execute-o de verdade com entradas de exemplo, que chegam ao script como $input. Os scripts rodam no PowerShell 6.2 pelo Try It Online (tio.run), um serviço público gratuito, então estes exercícios evitam sintaxe exclusiva do PowerShell 7; seu script e a entrada de teste são enviados para lá.

Exercício 1

Lista para JSON

+25 XP

A entrada é a lista do dragão como CSV. Produza JSON compacto - sempre uma array - de objetos com apenas Name e Wingspan, onde Wingspan é um número, para dragões com envergadura de 10 m ou mais, o maior primeiro:

[{"Name":"Skyla","Wingspan":15},{"Name":"Ember","Wingspan":12},{"Name":"Vesper","Wingspan":11}]
  • Os residentes
  • Os visitantes
script.ps1
Carregando editor…

As aulas ensinam PowerShell 7; seu script roda no PowerShell 6.2 pelo Try It Online (tio.run), um serviço público gratuito, então use uma sintaxe que funcione lá. A entrada de teste chega ao script como $input. Seu script e a entrada de teste são enviados a esse serviço.

Exercício 2

Resumo da refeição do JSON

+25 XP

A entrada é um relatório de alimentação JSON (possivelmente em várias linhas). Imprima o goleiro, o total de quilogramas e o dragão que mais comeu:

Keeper: Ada
Total: 47 kg
Hungriest: Ember (40 kg)
  • Relatório de Ada
  • Relatório de Grace
script.ps1
Carregando editor…

As aulas ensinam PowerShell 7; seu script roda no PowerShell 6.2 pelo Try It Online (tio.run), um serviço público gratuito, então use uma sintaxe que funcione lá. A entrada de teste chega ao script como $input. Seu script e a entrada de teste são enviados a esse serviço.

Dúvidas sobre esta lição

Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.

Carregando publicações…