CSV, JSON e formatação
Importe e exporte CSV e JSON, modele objetos com propriedades calculadas e formate a saída para pessoas.
- 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:
| Formato | Leia | Escreva |
|---|---|---|
| Arquivo CSV | Import-Csv dragons.csv | Export-Csv dragons.csv -NoTypeInformation |
| Texto CSV | ConvertFrom-Csv | ConvertTo-Csv |
| Texto JSON | ConvertFrom-Json | ConvertTo-Json |
| JSON de uma API web | Invoke-RestMethod https://... | |
| Formato próprio do PowerShell | Import-Clixml | Export-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.
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].dragonString
[{"Name":"Ember","Wingspan":"12"},{"Name":"Glim","Wingspan":"2"}]
Ada
41
EmberConvertFrom-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, rainPropriedades 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:
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"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 caberFormat-List *- uma propriedade por linha, todas propriedadesOut-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.
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-ListName 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
-Depthe@( )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á.
Lista para JSON
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
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.
Resumo da refeição do JSON
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
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…