DataTableコマンド
mabl CLIでのDataTableの管理
mabl CLIでは、ワークスペースからDataTableのリスト表示、クエリ、作成、更新、エクスポートをプログラムで実行できます。
mabl CLIのドキュメント
DataTableコマンドのCLIドキュメントを表示するには、
mabl datatables -h
またはmabl datatables --help
を実行します。
mabl datatables list
ワークスペース内のDataTableをリスト表示します。
$ mabl datatables list <optional_arguments>
オプションの引数
オプション | 詳細 |
---|---|
--workspace-id 、-w | DataTableをリスト表示するワークスペースID。デフォルトでは、mabl CLIはmabl config listコマンドの出力に表示されるワークスペースを使用します。 |
--limit 、-l | 返すDataTableの数。デフォルトは10です。 |
--output 、-o | 出力形式を指定します。デフォルトはテーブルです。"yaml"または"json"のいずれかを指定できます。 |
出力
mabl datatables list
コマンドは、DataTableのID、名前、作成日時から成るテーブルを返します。
┌──────────────────────────┬─────────────────────────────────┬─────────────────────────┐
│ ID │ Name │ Created time │
├──────────────────────────┼─────────────────────────────────┼─────────────────────────┤
│ <datatable-id> │ Localization │ Oct 29th 2019, 22:06:55 │
├──────────────────────────┼─────────────────────────────────┼─────────────────────────┤
│ <datatable-id> │ Login check │ Mar 19th 2020, 14:15:01 │
├──────────────────────────┼─────────────────────────────────┼─────────────────────────┤
│ <datatable-id> │ Sample data │ Mar 23rd 2020, 17:57:23 │
├──────────────────────────┼─────────────────────────────────┼─────────────────────────┤
│ <datatable-id> │ Example scenarios │ Jun 16th 2022, 01:28:37 │
└──────────────────────────┴─────────────────────────────────┴─────────────────────────┘
例
# List 20 DataTables in the workspace
$ `mabl datatables list --limit 20 `
# List DataTables in yaml format
$ `mabl datatables list --output yaml`
# List five DataTables in json format
$ `mabl datatables list --limit 5 --output json`
mabl datatables describe
DataTable IDで指定した特定のDataTableの詳細情報を表示します。
オプションの引数
オプション | 詳細 |
---|---|
--output , -o | 出力形式を指定します。デフォルトはyamlです。"yaml"または"json"のいずれかを指定できます。 |
出力
mabl datatables describe
コマンドは、特定のDataTableの詳細情報を返します。これには、ワークスペースID、DataTableの名前、シナリオID、作成日時と作成者、最終更新日時と更新者の情報が含まれます。
id: <datatable_id>
organization_id: <workspace_id>
name: <name of datatable>
scenario_ids:
- <scenario_id>
- <scenario_id>
- <scenario_id>
created_time: 1668189822349
created_by_id: <user_id>
last_updated_time: 1673469977382
last_updated_by_id: <user_id>
例
# Describe DataTable in JSON format
$ mabl datatables describe <datatable-id> --format json
mabl datatables create
JSONまたはCSVファイルからDataTableを作成します。ファイル入力には、DataTableを作成するのに使用するファイルの相対パスを指定します。
$ mabl datatables create <file-input> <optional_arguments>
オプションの引数
オプション | 詳細 |
---|---|
--workspace-id , -w | DataTableを作成するワークスペースID。デフォルトでは、mabl CLIはmabl config list コマンドの出力に表示されるワークスペースを使用します。 |
--name , --table-name | 新しく作成するDataTableの名前。名前を指定しない場合、DataTableの名前は指定したファイルと同じ名前になります。 |
--format , --fmt | ファイル入力にファイル拡張子がない場合は、入力ファイルの形式として、"json" または "csv" を指定します。 |
ファイル入力
JSON形式
[
{
"name": "English",
"variables": [
{
"name": "login",
"value": "Login"
},
{
"name": "greeting",
"value": "Welcome back"
},
{
"name": "logout",
"value": "Logout"
}
]
},
{
"name": "Spanish",
"variables": [
{
"name": "login",
"value": "Iniciar sesión"
},
{
"name": "greeting",
"value": "Qué bueno verte de nuevo"
},
{
"name": "logout",
"value": "Cerrar sesión"
}
]
}
]
CSV形式
Scenario name, login, greeting, logout
English, Login, Welcome back, Logout
Spanish, Iniciar sesión, Qué bueno verte de nuevo, Cerrar sesión
出力
DataTableを作成する場合、mabl CLIは、新しく作成されるDataTableの詳細情報を返します。これには、ワークスペースID、DataTableの名前、シナリオID、作成日時と作成者、および最終更新日時と更新者の情報が含まれます。
id: <datatable_id>
organization_id: <workspace_id>
name: <name of datatable>
scenario_ids:
- <scenario_id>
- <scenario_id>
- <scenario_id>
created_time: 1668189822349
created_by_id: <user_id>
last_updated_time: 1673469977382
last_updated_by_id: <user_id>
例
# Create a DataTable from a JSON file
$ mabl datatables create login_check.json --name "Login check"
# Create a DataTable from a CSV file and name it "Sample data"
$ mabl datatables create samples.csv --name "Sample data"
mabl datatables update
JSONまたはCSVファイルを使ってmablのDataTableを更新します。ファイル入力には、DataTableを更新するのに使用するファイルの相対パスを指定します。
$ mabl datatables update <datatable-id> <file-input>
オプションの引数
オプション | 詳細 |
---|---|
--workspace-id , -w | DataTableを作成するワークスペースID。デフォルトでは、mabl CLIはmabl config list コマンドの出力に表示されるワークスペースを使用します。 |
--format , --fmt | ファイル入力にファイル拡張子がない場合は、入力ファイルの形式として、"json" または "csv" を指定します。 |
例
# Update a DataTable from a JSON file called test.json
$ mabl datatables update <datatable-id> test.json
# Update a DataTable from a CSV file called test.csv
$ mabl datatables update <datatable-id> test.csv
mabl datatables export
mablのDataTableを指定されたファイル形式でエクスポートします。
$ mabl datatables export <datatable-id> <optional_arguments>
オプションの引数
オプション | 詳細 |
---|---|
--format , --fmt | Specify the format for the datatable export: "yaml", "json", or "csv" |
出力
このコマンドを実行すると、DataTableのシナリオとシナリオの値を含むエクスポートされたファイルが出力されます。
例
# Export a DataTable in json format
$ mabl datatables export <datatable-id> --format json
# Export a DataTable in csv format
$ mabl datatables export <datatable-id> --format csv
Updated 20 days ago