machloader

machloader は、テキストファイルと Machbase 間でデータをインポート、エクスポートします。既定は CSV ですが、他の形式もサポートします。

主な機能と注意事項を示します。

スキーマファイルで日時形式を指定できます。サーバーがサポートする形式を使用してください。全フィールドに共通の形式、または列ごとに異なる形式を指定できます。
既存データを削除してから入力する場合は、-m replace を使用します。
スキーマとデータファイルの整合性は検証しません。スキーマ、テーブル、ファイルの整合性は利用者が確認してください。
既定では APPEND モードを使用します。
既定では _ARRIVAL_TIME を使用しません。この列を入出力するには -a を指定します。

日時の書式指定子は TO_CHAR を参照してください。

次のコマンドでオプションを確認できます。

[mach@localhost]$ machloader -h

オプション	説明
-s, –server=SERVER	サーバー IP（既定値：127.0.0.1）
-u, –user=USER	接続ユーザー（既定値：SYS）
-p, –password=PASSWORD	パスワード（既定値：MANAGER）
-P, –port=PORT	サーバーポート（既定値：5656）
-i, –import	インポート
-o, –export	エクスポート
-c, –schema	テーブル情報からスキーマファイルを作成
-t, –table=TABLE_NAME	スキーマ作成対象のテーブル名
-f, –form=SCHEMA_FORM_FILE	スキーマファイル名
-d, –data=DATA_FILE	データファイル名
-l, –log=LOG_FILE	実行ログファイル
-b, –bad=BAD_FILE	-i 実行時の入力エラーデータと、その説明を記録するファイル
-m, –mode=MODE	-i の入力方式。append は既存データに追加、replace は既存データを削除してから入力
-D, –delimiter=DELIMITER	フィールド区切り文字（既定値：,）
-n, –newline=NEWLINE	レコード区切り文字（既定値：\n）
-e, –enclosure=ENCLOSURE	各フィールドの囲み文字
-r, –format=FORMAT	入出力形式（既定値：csv）
–first=FIRST_ROW	処理を開始する行番号
-a, –atime	組み込み列 `_ARRIVAL_TIME` を使用するか。既定では使用しない
-z, –timezone	タイムゾーン。例：+0900、-1230
-I, –silent	著作権表示と入出力状況を非表示にする
-h, –help	オプション一覧を表示
-F, –dateformat=DATEFORMAT	列の日時形式。例：`_arrival_time YYYY-MM-DD HH24:MI:SS`。 unixtimestamp を指定すると Unix タイムスタンプとして扱う（`time_column unixtimestamp`）。 nanotimestamp ではナノ秒時刻として扱う（`time_column nanotimestamp`）
-E, –encoding=CHARACTER_SET	入出力ファイルの文字コード。UTF8（既定）、ASCII、MS949、KSC5601、EUCJP、SHIFTJIS、BIG5、GB231280、UTF16 に対応
-C, –create	インポート先のテーブルがなければ作成
-H, –header	入出力時のヘッダーの有無。既定は未指定
–summary	選択した設定を表示して終了。データの入出力は行わない
-S, –slash	バックスラッシュ区切りを指定

詳しい使用方法を示します。

CSV ファイルのインポート

CSV をサーバーへ読み込みます。

オプション：

-i：インポートを指定
-d：データファイル名を指定
-t：テーブル名を指定

例：

machloader -i -d data.csv -t table_name

CSV ファイルのエクスポート

データを CSV に書き出します。

オプション：

-o：エクスポートを指定
-d：データファイル名を指定
-t：テーブル名を指定

例：

machloader -o -d data.csv -t table_name

CSV ヘッダーの使用

ヘッダーを扱う設定です。

オプション：

-i -H：CSV の先頭行をヘッダーとして扱い、データ入力から除外
-o -H：列名の CSV ヘッダーを出力

例：

machloader -i -d data.csv -t table_name -H
machloader -o -d data.csv -t table_name -H

テーブルの自動作成

入力時の自動作成を設定します。

オプション：

-C：入力時にテーブルを自動作成。列名は c0、c1、...、型は VARCHAR(32767)
-H：CSV ヘッダーを列名として使用

例：

machloader -i -d data.csv -t table_name -C
machloader -i -d data.csv -t table_name -C -H

CSV 以外の形式

CSV 以外のファイルには、区切り文字を設定します。

オプション：

-D：フィールド区切り文字を指定
-n：レコード区切り文字を指定
-e：フィールドの囲み文字を指定

例：

machloader -i -d data.txt -t table_name -D '^' -n '\n' -e '"'
machloader -o -d data.txt -t table_name -D '^' -n '\n' -e '"'

入力モードの指定

インポート（-i）には REPLACE と APPEND があり、既定は APPEND です。REPLACE は既存データを削除するため、注意してください。

オプション：

-m：インポートモードを指定

例：

machloader -i -d data.csv -t table_name -m replace

接続情報の指定

サーバー IP、ユーザー、パスワードを個別に指定します。

オプション：

-s：サーバー IP（既定値 127.0.0.1）
-P：ポート（既定値 5656）
-u：ユーザー名（既定値 SYS）
-p：パスワード（既定値 MANAGER）

例：

machloader -i -s 192.168.0.10 -P 5656 -u mach -p machbase -d data.csv -t table_name

ログファイルの作成

machloader の実行ログと、入力に失敗した行を記録するbad-dataファイルを作成します。

オプション：

-b：インポートに失敗したデータの出力ファイル
-l：入力に失敗したデータとエラーメッセージのログファイル

例：

machloader -i -d data.csv -t table_name -b table_name.bad -l table_name.log

スキーマファイルの作成

スキーマファイルを作成できます。型の形式を変更する場合や、テーブルとファイルで列数が異なる場合も、スキーマで対応付けて入出力できます。

オプション：

-c：スキーマファイルを作成
-t：テーブル名を指定
-f：スキーマファイル名を指定

例：

machloader -c -t table_name -f table_name.fmt
machloader -c -t table_name -f table_name.fmt -a

スキーマファイルの日時形式

DATEFORMAT で日時形式を指定します。

構文：

#すべての日時列に設定
DATEFORMAT <dateformat>

日時列ごとの設定

DATEFORMAT <column_name> <format>

例：

-- datetest.fmt で、datetest.csv の各列の日時形式を指定
datetest.fmt
table datetest
{
INS_DT datetime;
UPT_DT datetime;
}
DATEFORMAT ins_dt "YYYY/MM/DD HH12:MI:SS"
DATEFORMAT upt_dt "YYYY DD MM HH12:MI:SS"
 
datetest.csv
2017/02/20 11:05:23,2017 20 02 11:05:23
2017/02/20 11:06:34,2017 20 02 11:06:34
 
-- datetest.csv を入力して結果を確認
machloader -i -f datetest.fmt -d datetest.csv
-----------------------------------------------------------------
Machbase Data Import/Export Utility.
Release Version 8.5.4.develop
Copyright 2014, MACHBASE Corporation or its subsidiaries.
All Rights Reserved.
-----------------------------------------------------------------
Import time : 0 hour 0 min 0.39 sec
Load success count : 2
Load fail count : 0
 
mach> SELECT * FROM datetest;
INS_DT UPT_DT
-------------------------------------------------------------------
2017-02-20 11:06:34 000:000:000 2017-02-20 11:06:34 000:000:000
2017-02-20 11:05:23 000:000:000 2017-02-20 11:05:23 000:000:000
[2] row(s) selected.
Elapsed time: 0.000

IGNORE

CSV の特定のフィールドを入力しない場合、fmt ファイルで IGNORE を指定します。 ignoretest.csv は 3 フィールドあります。最後のフィールドが不要なら、fmt ファイルでその位置に IGNORE を指定します。

例：

-- ignoretest.fmt の最後のフィールドに IGNORE を指定
ignoretest.fmt
table ignoretest
{
ID integer;
MSG varchar(40);
SUB_ID integer IGNORE;
}
 
ignoretest.csv
1, "msg1", 3
2, "msg2", 4
 
 
-- ignoretest.csv を入力して結果を確認
machloader -i -f ignoretest.fmt -d ignoretest.csv
-----------------------------------------------------------------
Machbase Data Import/Export Utility.
Release Version 8.5.4.develop
Copyright 2014, MACHBASE Corporation or its subsidiaries.
All Rights Reserved.
-----------------------------------------------------------------
NLS : US7ASCII EXECUTE MODE : IMPORT
SCHEMA FILE : ignoretest.fmt DATA FILE : ignoretest.csv
IMPORT_MODE : APPEND FIELD TERM : ,
ROW TERM : \n ENCLOSURE : "
ARRIVAL_TIME : FALSE ENCODING : NONE
HEADER : FALSE CREATE TABLE : FALSE
 
Progress bar Imported records Error records
2 0
 
Import time : 0 hour 0 min 0.39 sec
Load success count : 2
Load fail count : 0
 
 
mach> SELECT * FROM ignoretest;
ID MSG
---------------------------------------------------------
2 msg2
1 msg1
[2] row(s) selected.
Elapsed time: 0.000

テーブルの列数がファイルのフィールド数より多い場合

スキーマで指定した列だけに入力し、残りの列には NULL を格納します。

テーブルの列数がファイルのフィールド数より少ない場合

テーブルに対応しないフィールドは IGNORE で除外する必要があります。

例：

-- 最後のフィールドを IGNORE で除外して入力
loader_test.fmt
table loader_test
{
ID integer;
MSG varchar (40);
SUB_ID integer IGNORE;
}

最終更新日 9月 10, 2026

machadmin machsql