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 コマンドレットは、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、出力構成を json として BLOB に対して正常に照会し、出力をローカル ファイル "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 スナップショットに対してクエリを実行し、クエリ エラーを含む結果を表示します。

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。