Get-AzStorageBlobQueryResult

Get-AzStorageBlobQueryResult
    [-Blob] <String>
    [-Container] <String>
    -QueryString <String>
    -ResultFile <String>
    [-SnapshotTime <DateTimeOffset>]
    [-VersionId <String>]
    [-InputTextConfiguration <PSBlobQueryTextConfiguration>]
    [-OutputTextConfiguration <PSBlobQueryTextConfiguration>]
    [-PassThru]
    [-Force]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Get-AzStorageBlobQueryResult
    -BlobBaseClient <BlobBaseClient>
    -QueryString <String>
    -ResultFile <String>
    [-InputTextConfiguration <PSBlobQueryTextConfiguration>]
    [-OutputTextConfiguration <PSBlobQueryTextConfiguration>]
    [-PassThru]
    [-Force]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Get-AzStorageBlobQueryResult
    [-Blob] <String>
    -BlobContainerClient <BlobContainerClient>
    -QueryString <String>
    -ResultFile <String>
    [-SnapshotTime <DateTimeOffset>]
    [-VersionId <String>]
    [-InputTextConfiguration <PSBlobQueryTextConfiguration>]
    [-OutputTextConfiguration <PSBlobQueryTextConfiguration>]
    [-PassThru]
    [-Force]
    [-TagCondition <String>]
    [-Context <IStorageContext>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Get-AzStorageBlobQueryResult cmdlet 对 Blob 的内容应用简单的结构化查询语言（SQL）语句，并将查询的数据子集保存到本地文件。

$inputconfig = New-AzStorageBlobQueryConfig -AsCsv -HasHeader

$outputconfig = New-AzStorageBlobQueryConfig -AsJson

$queryString = "SELECT * FROM BlobStorage WHERE Name = 'a'"

$result = Get-AzStorageBlobQueryResult -Container $containerName -Blob $blobName -QueryString $queryString -ResultFile "c:\resultfile.json" -InputTextConfiguration $inputconfig -OutputTextConfiguration $outputconfig -Context $ctx

$result

BytesScanned FailureCount BlobQueryError
------------ ------------ --------------
         449            0

此命令成功查询输入配置为 csv 的 blob，并将输出配置为 json，并将输出保存到本地文件“c：\resultfile.json”。

$blob = Get-AzStorageBlob -Container $containerName -Blob $blobName -SnapshotTime "2020-07-29T11:08:21.1097874Z" -Context $ctx

$inputconfig = New-AzStorageBlobQueryConfig -AsCsv -ColumnSeparator "," -QuotationCharacter """" -EscapeCharacter "\" -RecordSeparator "`n" -HasHeader

$outputconfig = New-AzStorageBlobQueryConfig -AsJson -RecordSeparator "`n"

$queryString = "SELECT * FROM BlobStorage WHERE _1 LIKE '1%%'"

$result = $blob | Get-AzStorageBlobQueryResult -QueryString $queryString -ResultFile $localFilePath -InputTextConfiguration $inputconfig -OutputTextConfiguration $outputconfig

$result

BytesScanned FailureCount BlobQueryError
------------ ------------ --------------
   187064971            1 {ParseError}



$result.BlobQueryError

Name       Description                                                   IsFatal Position
----       -----------                                                   ------- --------
ParseError Unexpected token '1' at [byte: 3077737]. Expecting token ','.    True  7270632

此命令首先获取 Blob 快照的 Blob 对象，然后查询 Blob 快照并显示结果包括查询错误。

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。