Hologres:Use the COPY command to export Hologres data to OSS

COPY TO コマンドの構文とパラメーターは次のとおりです。

• 構文

  COPY ( query ) TO { PROGRAM 'command' | STDOUT }
      [ [ WITH ] ( option [, ...] ) ]

  option には、次のいずれかを指定できます。

  FORMAT [format_name]
  DELIMITER 'delimiter_character'
  NULL 'null_string'
  HEADER
  QUOTE 'quote_character'
  ESCAPE 'escape_character'
  ENCODING 'encoding_name'

• パラメーター

  パラメーター	説明
  query	実行するクエリ文。クエリ文を囲む括弧は必須です。
  PROGRAM	実行するコマンド。出力はコマンドの標準入力に書き込まれます。
  STDOUT	出力がクライアントアプリケーションに送信されることを指定します。
  FORMAT	データ形式を選択します。形式は、テキスト、csv、またはバイナリです。デフォルトはテキストです。
  DELIMITER	ファイルの各行内の列を区切る文字を指定します。これは 1 バイトの単一文字である必要があります。次のリストは、さまざまなデータ形式のデフォルト文字を示しています： テキスト形式の場合、デフォルトはタブ文字 (\t) です。 csv 形式の場合、デフォルトはコンマ (,) です。 このオプションはバイナリ形式ではサポートされていません。
  NULL	NULL 値を表す文字列を指定します。次のリストは、さまざまなデータ形式のデフォルト文字列を示しています： テキスト形式の場合、デフォルトは \N です。 csv 形式の場合、デフォルトは引用符で囲まれていない空文字列です。 このオプションはバイナリ形式ではサポートされていません。
  HEADER	ファイルに列名を含むヘッダー行があることを指定します。CSV ファイルのみがこのオプションをサポートします。
  QUOTE	QUOTE 値に一致するデータ文字の前に表示する必要がある文字を指定します。これは 1 バイトの単一文字である必要があります。デフォルトは QUOTE 値と同じです。CSV 形式のみがこのオプションをサポートします。
  ENCODING	ファイルが encoding_name でエンコードされていることを指定します。このオプションを省略した場合、現在のクライアントエンコーディングが使用されます。

次の例は、Hologres で hg_dump_to_oss コマンドを COPY TO コマンドと共に使用する方法を示しています。

-- Hologres 内部テーブルから指定された OSS のロケーションにデータをダンプします
COPY (SELECT * FROM holo_test LIMIT 2) TO PROGRAM 'hg_dump_to_oss --AccessKeyId <access id> --AccessKeySecret <access key> --Endpoint oss-cn-hangzhou-internal.aliyuncs.com --BucketName hologres-demo --DirName holotest/ --FileName file_name --BatchSize 3000' DELIMITER ',';

-- Hologres 外部テーブルから指定された OSS のロケーションにデータをダンプします
COPY (SELECT * FROM foreign_holo_test LIMIT 20) TO PROGRAM 'hg_dump_to_oss --AccessKeyId <access id> --AccessKeySecret <access key> --Endpoint oss-cn-hangzhou-internal.aliyuncs.com --BucketName hologres-demo --DirName holotest/ --FileName file_name --BatchSize 3000' (DELIMITER ',', HEADER true);

-- リージョン間のダンプを実行して、指定された OSS のロケーションにデータをダンプします
COPY (SELECT * FROM holo_test_1 LIMIT 20) TO PROGRAM 'hg_dump_to_oss --AccessKeyId <access id> --AccessKeySecret <access key> --Endpoint oss-cn-beijing-internal.aliyuncs.com --BucketName hologres-demo --DirName holotest/ --FileName file_name --BatchSize 3000' (DELIMITER ',', HEADER true, FORMAT CSV);

一般的なエラーとそのソリューションを次に示します：

• ERROR: syntax error at or near ")"LINE 1: COPY (select 1,2,3 from ) TO PROGRAM 'hg_dump_to_oss2 --Acce...

  入力された query が無効です。クエリ文を確認してください。

• DETAIL: child process exited with exit code 255

  選択した OSS ネットワークタイプが正しくありません。パブリッククラウドを使用している場合は、クラシックネットワークを選択してください。

• DETAIL: command not found

  DUMP TO OSS の [プログラム] パラメーターを hg_dump_to_oss に設定する必要があります。そうしないと、このエラーが発生します。

• ERROR: program "hg_dump_to_oss ...” failed DETAIL: child process exited with exit code 101

  入力された AccessKeyId が無効です。ご利用のアカウントの AccessKey ID を使用してください。

• ERROR: program "hg_dump_to_oss ...” failed DETAIL: child process exited with exit code 102

  入力された AccessKeySecret が無効です。ご利用のアカウントの AccessKey Secret を使用してください。

• ERROR: program "hg_dump_to_oss ...” failed DETAIL: child process exited with exit code 103

  入力された Endpoint が無効です。対応する OSS クラシックネットワークのエンドポイントを確認してください。

• ERROR: program "hg_dump_to_oss ...” failed DETAIL: child process exited with exit code 104

  入力された BucketName が無効です。バケット名を確認してください。

• ERROR: program "hg_dump_to_oss ..." failed DETAIL: child process exited with exit code 105

  必須パラメーターがありません。パラメーターの説明を確認し、すべての必須パラメーターが設定されていることを確認してください。

• ERROR: program "hg_dump_to_oss ...” failed DETAIL: child process exited with exit code 255

  このエラーは通常、Hologres サーバーが指定された OSS ネットワークに接続できないために発生します。OSS ドメイン名を変更できます。たとえば、OSS ネットワークタイプとしてクラシックネットワークを選択します。OSS ドメイン名の詳細については、「リージョンとエンドポイント」をご参照ください。