すべてのプロダクト
Search
ドキュメントセンター

MaxCompute:アーカイブファイル関数

最終更新日:Sep 02, 2026

MaxCompute には、アーカイブファイルのバイナリデータを SQL で直接解析するための組み込みスカラー関数が用意されています。zip、jar、tar、tar.gz、tar.bz2、tar.xz、tar.zst などの形式のファイルメタデータとコンテンツを、ディスクに展開せずに読み取ることができます。

このトピックのすべての SQL サンプルは、実行可能ステートメントです。バイナリ入力パラメーターには、完全な x'...' 16進数リテラルを使用する必要があります。

関数概要

次の 2 つの関数は スカラー関数 であり、テーブル値関数ではありません。これらの関数は複合データ型 (ARRAY / MAP) を返し、SELECT 句 で直接使用できます。

関数名

入力

戻り値の型

使用法

LIST_ARCHIVE_METADATA

BINARY

ARRAY<STRUCT<file_path:STRING, size:BIGINT, mtime:BIGINT>>

アーカイブファイル内のすべてのエントリのメタデータを一覧表示します。

GET_ARCHIVE_CONTENT

BINARY [, STRING]

MAP<STRING, STRING>

アーカイブファイルからファイル名とそのテキストコンテンツのマップを抽出します。

使用上の注意

  • 入力タイプ

    どちらの関数も、BINARY 入力のみを受け付けます。データが STRING の場合、まずキャストする必要があります。

  • コンテンツのデコード

    • GET_ARCHIVE_CONTENT は、バイナリからデコードしてコンテンツを STRING として返します。

    • 画像やクラスファイルなどの非テキストファイルは、文字化けする場合があります。

  • メモリ使用量

    これらの関数は、解析のためにアーカイブファイルのコンテンツ全体をメモリに読み込みます。非常に大きなアーカイブファイルは、大量のリソースを消費する可能性があります。1 レコードあたりのサイズを制限してください。

  • 自動フォーマット検出

    フォーマットを指定する必要はありません。これらの関数は、バイナリ コンテンツに基づいてフォーマットを自動的に検出します。

  • ファイル名のみのパターンマッチング

    ワイルドカードは、ファイルの内容ではなく、アーカイブファイル内のエントリの file_path に一致します。

  • ディレクトリエントリ

    JAR ファイルまたは ZIP ファイル内のディレクトリ エントリ (META-INF/ など) は、LIST_ARCHIVE_METADATA では size が 0 になり、GET_ARCHIVE_CONTENT ではその値が空の文字列になります。

  • mtime の欠落

    tar.gz 形式の mtime は 0 になる場合があります。

対応アーカイブおよび圧縮フォーマット

これらの関数は、バイナリ コンテンツに基づいてフォーマットを 自動的に検出 します。フォーマットを指定する必要はありません。

対応フォーマット

フォーマット

マジックナンバー

コンテナ

圧縮アルゴリズム

zip (stored)

50 4b 03 04

ZIP

stored (メソッド 0)

zip (deflate)

50 4b 03 04

ZIP

deflate (メソッド 8)

jar

50 4b 03 04

ZIP

通常は stored

tar

統一されたマジックナンバーなし

TAR

圧縮なし

tar.gz

1f 8b 08

TAR

gzip

tar.bz2

42 5a 68 (BZh)

TAR

bzip2

tar.xz

fd 37 7a 58 5a

TAR

xz

tar.zst

28 b5 2f fd

TAR

zstd

フォーマット検出の仕組み

  • zip / jar: PK ヘッダー (0x504b0304) を検出します。zip エントリでは、stored (メソッド 0) と deflate (メソッド 8) の 2 つの圧縮メソッドをサポートしています。JAR ファイルは、本質的には META-INF/ ディレクトリ エントリも含む zip ファイルです。

  • tar.gz / tar.bz2 / tar.xz / tar.zst: システムはまず外側の圧縮ヘッダー (gzip 1f 8b 08、bzip2 42 5a 68、xz fd 37 7a 58 5a、または zstd 28 b5 2f fd) を検出し、その後、内側の tar アーカイブを解凍して解析します。

  • tar: 外側の圧縮はありません。tar の 512 バイト ブロック構造に基づいて、データを直接解析します。

LIST_ARCHIVE_METADATA

この関数は、アーカイブファイル内のすべてのエントリのメタデータを一覧表示します。

構文

LIST_ARCHIVE_METADATA(<binary_input>)

パラメーター

binary_input:必須。アーカイブファイルの BINARY コンテンツです。

戻り値

ARRAY<STRUCT<file_path:STRING, size:BIGINT, mtime:BIGINT>> 型の ARRAY を返します。配列の各要素は、ディレクトリ エントリを含め、アーカイブファイル内のエントリを表します。フィールドは次のとおりです:

フィールド

タイプ

説明

file_path

STRING

アーカイブファイル内のエントリの相対パスです (例:hello.txt または META-INF/MANIFEST.MF)。

size

BIGINT

エントリの非圧縮サイズ (バイト単位) です。ディレクトリ エントリの場合、この値は 0 です。

mtime

BIGINT

エントリの変更時刻で、秒単位の UNIX タイムスタンプです。場合によっては、値が 0 になることがあります。

配列の順序: 要素は、アーカイブファイル内での出現順に返されます。

例

例 1:オブジェクトテーブルの使用

  1. テストデータファイル test_01.zip を OSS にアップロードします。

  2. オブジェクトテーブルを作成してメタデータを読み取ります。

    -- オブジェクトテーブルを作成
    SET odps.namespace.schema=true; 
    
    CREATE OBJECT TABLE ot_test_01 
    WITH serdeproperties ( 
     'odps.properties.rolearn'='acs:ram::<uid>:role/aliyunodpsdefaultrole') 
    LOCATION 'oss://oss-<region>-internal.aliyuncs.com/<oss-path>/'
    ;
    
    -- メタデータを更新
    ALTER TABLE ot_test_01 REFRESH METADATA;
    
    -- オブジェクトテーブルをクエリ
    SET odps.namespace.schema=true;
    SELECT * FROM ot_test_01;
    
    -- 次の結果が返されます。
    +------+------------+------+---------------+---------------+------+--------------+------------+--------------------+
    | key  | size       | type | last_modified | storage_class | etag | restore_info | owner_id   | owner_display_name |
    +------+------------+------+---------------+---------------+------+--------------+------------+--------------------+
    | test_01.zip | 7246 | Normal | 2026-08-31 06:40:38 | Standard | 337E*****3101C02F1 | NONE| 122***014 | 122***014  |
    +------+------------+------+---------------+---------------+------+--------------+------------+--------------------+
  3. アーカイブ関数を使用して、すべてのエントリのメタデータを一覧表示します。

    SET odps.namespace.schema=true;
    
    SELECT 
        LIST_ARCHIVE_METADATA(data) FROM 
    (
        SELECT 
            GET_DATA_FROM_OSS('<project>.<schema>.ot_test_01', key) as data
        FROM ot_test_01
    );
    
    -- 次の結果が返されます。
    +------+
    | _c0  |
    +------+
    | [{file_path:test_01/, size:0, mtime:1786418145}, {file_path:test_01/hello.txt, size:13, mtime:1786418039}, {file_path:__MACOSX/test_01/._hello.txt, size:5106, mtime:1786418039}, {file_path:test_01/data.txt, size:13, mtime:1786418061}, {file_path:__MACOSX/test_01/._data.txt, size:5122, mtime:1786418061}] |
    +------+

例 2:その他のフォーマット

Zip フォーマット

hello.txt(「hello world」)と data.txt(「テストデータ 123」)を含む zip ファイル。

SELECT LIST_ARCHIVE_METADATA(x'504b030414000000000000006f5785114a0d0b0000000b0000000900000068656c6c6f2e74787468656c6c6f20776f726c64504b030414000000000000006f57ff35e1450d0000000d00000008000000646174612e74787474657374206461746120313233504b0102140314000000000000006f5785114a0d0b0000000b00000009000000000000000000000080010000000068656c6c6f2e747874504b0102140314000000000000006f57ff35e1450d0000000d000000080000000000000000000000800132000000646174612e747874504b050600000000020002006d000000650000000000');

-- 次の結果が返されます。
[{file_path:hello.txt, size:11, mtime:1699977600}, {file_path:data.txt, size:13, mtime:1699977600}]

Jar およびストア形式

META-INF/、META-INF/MANIFEST.MF、および hello.txt (内容は「hello jar」) を含むストア形式の JAR ファイル。

SELECT LIST_ARCHIVE_METADATA(x'504b03040a0000080000f4a1bc5c000000000000000000000000090004004d4554412d494e462ffeca0000504b03040a0000080000f4a1bc5c6388d7f13a0000003a000000140000004d4554412d494e462f4d414e49464553542e4d464d616e69666573742d56657273696f6e3a20312e300d0a437265617465642d42793a20312e382e305f3334352028416c6962616261290d0a0d0a504b03040a000008000014a0bc5cdf3b649609000000090000000900000068656c6c6f2e74787468656c6c6f206a6172504b01020a000a0000080000f4a1bc5c0000000000000000000000000900040000000000000000000000000000004d4554412d494e4e462ffeca0000504b01020a000a0000080000f4a1bc5c6388d7f13a0000003a00000014000000000000000000000000002b0000004d4554412d494e462f4d414e49464553542e4d46504b01020a000a000008000014a0bc5cdf3b6496090000000900000009000000000000000000000000009700000068656c6c6f2e747874504b05060000000003000300b4000000c70000000000');

-- 次の結果が返されます。
[{file_path:META-INF/, size:0, mtime:1779970540}, {file_path:META-INF/MANIFEST.MF, size:58, mtime:1779970540}, {file_path:hello.txt, size:9, mtime:1779969640}]

-- 注: jar ファイルには、サイズが 0 の META-INF/ ディレクトリ エントリが含まれます。

Tar.gz フォーマット

「hello world」と記述されたhello.txt と、「test data 123」と記述されたdata.csv を含む tar.gz ファイル。

SELECT LIST_ARCHIVE_METADATA(x'1f8b08000000000002ffedd3410a83400c85e1394a4e20998edaf30c5570312038b1edf1eb74d3e2da5ac4ffdb2464179237f4298d953dcdfd8e2edaba7ed7c5baaafaf0e9cbdc7bd5e044dd0ee66c7112d964c9efe50e6228f797c738a5cee17cba68b1bae5bbfb6bfe9b55feb569afe47f0fd66793f204e22f813800000000000000000000000001cce0b293b365100280000');

-- 次の結果が返されます。
[{file_path:hello.txt, size:11, mtime:0}, {file_path:data.csv, size:13, mtime:0}]

-- 注: tar.gz ファイルの mtime は、内部の TAR ヘッダーの時刻フィールドによっては 0 になる場合があります。

Tar フォーマット

「hello world」と記述された hello.txt を含む tar ファイル。

SELECT LIST_ARCHIVE_METADATA(x'68656c6c6f2e7478740000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000030303030363434003030303030303000303030303030300030303030303030303031330031343532343737303430300030303736343500203000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007573746172003030000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000-');

-- 次の結果が返されます。
[{file_path:hello.txt, size:11, mtime:1700000000}]

GET_ARCHIVE_CONTENT

この関数は、アーカイブファイルからファイル名とコンテンツの MAP を抽出します。

構文

-- パターンなし:アーカイブ内のすべてのファイルのコンテンツを返します
GET_ARCHIVE_CONTENT(<binary_input>)

-- パターンあり:名前がパターンにマッチするファイルのコンテンツのみを返します
GET_ARCHIVE_CONTENT(<binary_input>, <pattern>)

パラメーター

パラメーター

タイプ

必須

説明

binary_input

BINARY

はい

アーカイブファイルの RAW バイトコンテンツです。

pattern

STRING

いいえ

glob 形式のファイル名マッチングパターンです。省略した場合、この関数はすべてのファイルを返します。

戻り値

MAP (MAP<STRING, STRING>) を返します。キーはファイル名 (file_path)、値は STRING としてデコードされたファイルコンテンツです。

  • META-INF/ などのディレクトリエントリの値は、空の文字列です。

  • MAP はファイル名のアルファベット順にソートされます。

パターンマッチングのルール

ワイルドカード

説明

例

*

0 文字以上の任意の文字列にマッチします

*.txt → すべての.txtファイル

?

任意の 1 文字にマッチします

h?llo.txt → hello.txt

.

リテラル文字

hello.* → hello.txt、hello.csv

その他の文字

リテラルマッチ

data.csv → data.csvのみ

パターンはファイル名にのみマッチし、ファイルコンテンツにはマッチしません。パターンにマッチするファイルがない場合、空の MAP {} が返されます。

例

例1:オブジェクトテーブルの使用

  1. テストデータファイル test_01.zip を OSS にアップロードします。

  2. オブジェクトテーブルを作成してメタデータを読み取ります。

    -- オブジェクトテーブルを作成
    SET odps.namespace.schema=true; 
    
    CREATE OBJECT TABLE ot_test_01 
    WITH serdeproperties ( 
     'odps.properties.rolearn'='acs:ram::<uid>:role/aliyunodpsdefaultrole') 
    LOCATION 'oss://oss-<region>-internal.aliyuncs.com/<oss-path>/'
    ;
    
    -- メタデータをリフレッシュ
    ALTER TABLE ot_test_01 REFRESH METADATA;
    
    -- オブジェクトテーブルをクエリ
    SET odps.namespace.schema=true;
    SELECT * FROM ot_test_01;
    
    -- 次の結果が返されます。
    +------+------------+------+---------------+---------------+------+--------------+------------+--------------------+
    | key  | size       | type | last_modified | storage_class | etag | restore_info | owner_id   | owner_display_name |
    +------+------------+------+---------------+---------------+------+--------------+------------+--------------------+
    | test_01.zip | 7246 | Normal | 2026-08-31 06:40:38 | Standard | 337E*****3101C02F1 | NONE| 122***014 | 122***014  |
    +------+------------+------+---------------+---------------+------+--------------+------------+--------------------+
  3. アーカイブ関数を使用して、ファイル名とコンテンツの MAP を抽出します。

    SET odps.namespace.schema=true;
    
    SELECT 
        GET_ARCHIVE_CONTENT(data,'test_01/hello.*') FROM 
    (
        SELECT 
            GET_DATA_FROM_OSS('<project>.<schema>.ot_test_01', key) as data
        FROM ot_test_01
    );
    
    -- 次の結果が返されます。
    +------+
    | _c0  |
    +------+
    | {test_01/hello.txt:hello world
    } |
    +------+

例2:その他のフォーマット

すべてのファイル (zip)

SELECT GET_ARCHIVE_CONTENT(x'504b030414000000000000006f5785114a0d0b0000000b0000000900000068656c6c6f2e74787468656c6c6f20776f726c64504b030414000000000000006f57ff35e1450d0000000d00000008000000646174612e74787474657374206461746120313233504b0102140314000000000000006f5785114a0d0b0000000b00000009000000000000000000000080010000000068656c6c6f2e747874504b0102140314000000000000006f57ff35e1450d0000000d000000080000000000000000000000800132000000646174612e747874504b050600000000020002006d000000650000000000');

-- 次の結果が返されます。
{data.txt:test data 123, hello.txt:hello world}

*.txt パターンの使用

SELECT GET_ARCHIVE_CONTENT(x'504b030414000000000000006f5785114a0d0b0000000b0000000900000068656c6c6f2e74787468656c6c6f20776f726c64504b030414000000000000006f57ff35e1450d0000000d00000008000000646174612e74787474657374206461746120313233504b0102140314000000000000006f5785114a0d0b0000000b00000009000000000000000000000080010000000068656c6c6f2e747874504b0102140314000000000000006f57ff35e1450d0000000d000000080000000000000000000000800132000000646174612e747874504b050600000000020002006d000000650000000000', '*.txt');

-- 次の結果が返されます。
{data.txt:test data 123, hello.txt:hello world}

hello.* パターンの使用

SELECT GET_ARCHIVE_CONTENT(x'504b030414000000000000006f5785114a0d0b0000000b0000000900000068656c6c6f2e74787468656c6c6f20776f726c64504b030414000000000000006f57ff35e1450d0000000d00000008000000646174612e74787474657374206461746120313233504b0102140314000000000000006f5785114a0d0b0000000b00000009000000000000000000000080010000000068656c6c6f2e747874504b0102140314000000000000006f57ff35e1450d0000000d000000080000000000000000000000800132000000646174612e747874504b050600000000020002006d000000650000000000', 'hello.*');

-- 次の結果が返されます。
{hello.txt:hello world}

Jar 形式と *.txt

*.txt を使用した jar ファイル (MANIFEST.MF とディレクトリを除外)。

SELECT GET_ARCHIVE_CONTENT(x'504b03040a0000080000f4a1bc5c000000000000000000000000090004004d4554412d494e462ffeca0000504b03040a0000080000f4a1bc5c6388d7f13a0000003a000000140000004d4554412d494e462f4d414e49464553542e4d464d616e69666573742d56657273696f6e3a20312e300d0a437265617465642d42793a20312e382e305f3334352028416c6962616261290d0a0d0a504b03040a000008000014a0bc5cdf3b649609000000090000000900000068656c6c6f2e74787468656c6c6f206a6172504b01020a000a0000080000f4a1bc5c0000000000000000000000000900040000000000000000000000000000004d4554412d494e462ffeca0000504b01020a000a0000080000f4a1bc5c6388d7f13a0000003a00000014000000000000000000000000002b0000004d4554412d494e462f4d414e49464553542e4d46504b01020a000a000008000014a0bc5cdf3b6496090000000900000009000000000000000000000000009700000068656c6c6f2e747874504b05060000000003000300b4000000c70000000000', '*.txt');

-- 次の結果が返されます。
{hello.txt:hello jar}

*.csv を含む Tar.gz

*.csv を使用した tar.gz ファイル (拡張子でフィルタリング)。

SELECT GET_ARCHIVE_CONTENT(x'1f8b08000000000002ffedd3410a83400c85e1394a4e20998edaf30c5570312038b1edf1eb74d3e2da5ac4ffdb2464179237f4298d953dcdfd8e2edaba7ed7c5baaafaf0e9cbdc7bd5e044dd0ee66c7112d964c9efe50e6228f797c738a5cee17cba68b1bae5bbfb6bfe9b55feb569afe47f0fd66793f204e22f81380000000000000000000000001cce0b293b365100280000', '*.csv');

-- 次の結果が返されます。
{data.csv:test data 123}

パターンなしの Tar

SELECT GET_ARCHIVE_CONTENT(x'68656c6c6f2e7478740000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000030303030363434003030303030303000303030303030300030303030303030303031330031343532343737303430300030303736343500203000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000007573746172003030000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000-');

-- 次の結果が返されます。
{hello.txt:hello world}

例外とエッジケース

LIST_ARCHIVE_METADATA と GET_ARCHIVE_CONTENT 関数は、例外をスローしません。 代わりに、NULL または空のコレクションを返すことで正常に失敗します:

シナリオ

入力

LIST_ARCHIVE_METADATA の戻り値

GET_ARCHIVE_CONTENT の戻り値

無効なアーカイブデータ

x'deadbeef'

NULL

NULL

NULL 入力

NULL

NULL

NULL

空のバイナリ

x''

[] (空の配列)

{} (空のマップ)

パターンがどのファイルにも一致しない

'<archive>', 'nonexistent.*'

—

{}

パターンが NULL

'<archive>', NULL

—

{}

区別:

  • 解析不能なデータの戻り値は NULL です。

  • 空の入力 (x'') は空のコレクションを返します。これは、空のバイナリは有効ですがコンテンツがない一方、deadbeef は認識されないフォーマットであるためです。

エッジケースの例

-- 無効なデータ → NULL
SELECT LIST_ARCHIVE_METADATA(x'deadbeef');        -- \N
SELECT GET_ARCHIVE_CONTENT(x'deadbeef');          -- \N

-- NULL 入力 → NULL
SELECT LIST_ARCHIVE_METADATA(NULL);               -- \N
SELECT GET_ARCHIVE_CONTENT(NULL);                 -- \N

-- 空のバイナリ → 空のコレクション
SELECT LIST_ARCHIVE_METADATA(x'');                -- []
SELECT GET_ARCHIVE_CONTENT(x'');                  -- {}

-- パターンが一致しない → 空のマップ
SELECT GET_ARCHIVE_CONTENT(x'504b030414000000000000006f5785114a0d0b0000000b0000000900000068656c6c6f2e74787468656c6c6f20776f726c64504b030414000000000000006f57ff35e1450d0000000d00000008000000646174612e74787474657374206461746120313233504b0102140314000000000000006f5785114a0d0b0000000b00000009000000000000000000000080010000000068656c6c6f2e747874504b0102140314000000000000006f57ff35e1450d0000000d000000080000000000000000000000800132000000646174612e747874504b050600000000020002006d000000650000000000', 'nonexistent.*');  -- {}

-- パターンが NULL → 空のマップ
SELECT GET_ARCHIVE_CONTENT(x'504b030414000000000000006f5785114a0d0b0000000b0000000900000068656c6c6f2e74787468656c6c6f20776f726c64504b030414000000000000006f57ff35e1450d0000000d00000008000000646174612e74787474657374206461746120313233504b0102140314000000000000006f5785114a0d0b0000000b00000009000000000000000000000080010000000068656c6c6f2e747874504b0102140314000000000000006f57ff35e1450d0000000d000000080000000000000000000000800132000000646174612e747874504b050600000000020002006d000000650000000000', NULL);  -- {}

複雑な戻り値の型の展開

これらの関数は ARRAY<STRUCT> や MAP<STRING,STRING> のような複雑なデータ型を返すため、 LATERAL VIEW EXPLODE を使用して結果を複数の行に展開できます。次の例では、 archives(id BIGINT, content BINARY) という名前のテーブルを想定しています。必要に応じて、テーブル名と列名を置き換えてください。

LIST_ARCHIVE_METADATA の結果の展開

-- テーブル archives(id BIGINT, content BINARY) にアーカイブデータが格納されているとします
SELECT id, meta.file_path, meta.size, meta.mtime
FROM archives
LATERAL VIEW EXPLODE(LIST_ARCHIVE_METADATA(content)) t AS meta
WHERE id = 1;

GET_ARCHIVE_CONTENT の結果の展開

SELECT id, k AS file_name, v AS file_content
FROM archives
LATERAL VIEW EXPLODE(GET_ARCHIVE_CONTENT(content, '*.txt')) t AS k, v
WHERE id = 1;

ファイルサイズによるフィルタリング

SELECT id, meta.file_path, meta.size
FROM archives
LATERAL VIEW EXPLODE(LIST_ARCHIVE_METADATA(content)) t AS meta
WHERE id = 1 AND meta.size > 10;

クイックリファレンス

この例では、hello.txt ("hello world") と data.txt ("test data 123") を含む ZIP アーカイブを使用します。16 進値は x'504b030414000000000000006f5785114a0d0b0000000b0000000900000068656c6c6f2e74787468656c6c6f20776f726c64504b030414000000000000006f57ff35e1450d0000000d00000008000000646174612e74787474657374206461746120313233504b0102140314000000000000006f5785114a0d0b0000000b00000009000000000000000000000080010000000068656c6c6f2e747874504b0102140314000000000000006f57ff35e1450d0000000d000000080000000000000000000000800132000000646174612e747874504b050600000000020002006d000000650000000000' です。

目的

SQL

結果

ファイルメタデータの一覧表示

SELECT LIST_ARCHIVE_METADATA(<zip_bin>);

[{file_path:hello.txt, size:11, mtime:1699977600}, {file_path:data.txt, size:13, mtime:1699977600}]

すべてのファイルコンテンツの取得

SELECT GET_ARCHIVE_CONTENT(<zip_bin>);

{data.txt:test data 123, hello.txt:hello world}

.txt ファイルのみ取得

SELECT GET_ARCHIVE_CONTENT(<zip_bin>, '*.txt');

{data.txt:test data 123, hello.txt:hello world}

"hello" で始まるファイルの取得

SELECT GET_ARCHIVE_CONTENT(<zip_bin>, 'hello.*');

{hello.txt:hello world}

一致なし

SELECT GET_ARCHIVE_CONTENT(<zip_bin>, 'nonexistent.*');

{}