MaxCompute では、データのアップロードおよびダウンロードに Tunnel を使用します。本トピックでは、Tunnel を使用したこれらの操作方法について説明します。
MaxCompute では、Tunnel コマンドを実行してデータをアップロードおよびダウンロードできます。Tunnel コマンドの全一覧については、「Tunnel コマンド」をご参照ください。
| 操作 | 説明 | 必要な権限 | ツール |
|---|---|---|---|
| データのアップロード | ローカルデータを MaxCompute テーブルに追加モードでアップロードします。 | 送信先テーブルの変更 | MaxCompute クライアント (odpscmd) |
| データのダウンロード | テーブルデータまたはインスタンスの実行結果をローカルマシンにダウンロードします。 | ソーステーブルで選択 | MaxCompute クライアント (odpscmd) |
データのアップロード
ローカルデータを MaxCompute テーブルに追加モードでアップロードします。MaxCompute へのデータアップロードは無料です。
制限事項
1 回の操作で、ファイルまたは第 1 階層のディレクトリを 1 つのテーブルまたは 1 つのパーティションにのみアップロードできます。
パーティションテーブルの場合、ターゲットパーティションを指定する必要があります。テーブルが複数階層のパーティションを持つ場合、最下位レベルのパーティションを指定してください。
構文
Tunnel upload <path> [<project_name>.]<table_name>[/<pt_spc>];パラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
path | はい | ローカルデータファイルのパス。デフォルトのファイル形式：TXT。 |
project_name | いいえ | 送信先テーブルを所有するプロジェクトの名前。プロジェクト間アクセス時に必要です。 |
table_name | はい | 送信先テーブルの名前。 |
pt_spc | いいえ | パーティションテーブルのパーティション指定。形式：partition_col1=col1_value1, partition_col2=col2_value1...。最下位レベルのパーティションを指定する必要があります。 |
OS 別のパス形式
| OS | パス形式 |
|---|---|
Windows (bin ディレクトリ内のファイル) | ファイル名.拡張子 |
| Windows (他のディレクトリ内のファイル) | D:\test\ファイル名.拡張子 |
| macOS | 絶対パスが必要です。例：/Users/ユーザー名/MaxCompute/bin/ファイル名.拡張子 |
使用例
例 1：非パーティション化テーブルへのアップロード
現在のプロジェクトの test_table に、MaxCompute クライアントの bin ディレクトリにある log.txt をアップロードします。
Tunnel upload log.txt test_table;例 2：プロジェクト間でのパーティションテーブルへのアップロード (Windows)
test_project 内の test_table の p1="b1",p2="b2" パーティションに、D:\test\ から log.txt をアップロードします。
Tunnel upload D:\test\log.txt test_project.test_table/p1="b1",p2="b2";データのダウンロード
MaxCompute テーブルのデータまたは指定されたインスタンスの実行結果を、ローカルマシン上のディレクトリにダウンロードします。
ダウンロードは転送データ量に基づいて課金されます。料金 = ダウンロードデータ量 (GB) × 0.1166 米ドル / GB。データはインターネット経由でのみダウンロード可能です。
制限事項
1 回の操作で、1 つのテーブルまたは 1 つのパーティションから 1 つのローカルファイルにのみデータをダウンロードできます。
パーティションテーブルの場合、ソースパーティションを指定する必要があります。テーブルが複数階層のパーティションを持つ場合、最下位レベルのパーティションを指定してください。
構文
Tunnel download [<project_name>.]<table_name>[/<pt_spc>] <path>;パラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
project_name | いいえ | ソーステーブルを所有するプロジェクトの名前。プロジェクト間アクセス時に必要です。 |
table_name | はい | ソーステーブルの名前。 |
pt_spc | いいえ | パーティションテーブルのパーティション指定。形式：partition_col1=col1_value1, partition_col2=col2_value1...。最下位レベルのパーティションを指定する必要があります。 |
path | はい | ローカルマシン上でのダウンロードファイルのパス。デフォルトのファイル形式：TXT。 |
使用例
例 1：MaxCompute クライアントディレクトリへのダウンロード
test_project.test_table の p1="b1",p2="b2" パーティションからデータをダウンロードし、MaxCompute クライアントの bin ディレクトリにある test_table.txt に保存します。
Tunnel download test_project.test_table/p1="b1",p2="b2" test_table.txt;例 2：カスタムディレクトリへのダウンロード (Windows)
同じパーティションデータを D:\test\test_table.txt にダウンロードします。
Tunnel download test_project.test_table/p1="b1",p2="b2" D:\test\test_table.txt;