> ## Documentation Index
> Fetch the complete documentation index at: https://documents.trocco.io/llms.txt
> Use this file to discover all available pages before exploring further.
# データマートジョブ実行
> データマートジョブを実行します。
## OpenAPI
````json POST /api/datamart_jobs
{
"openapi": "3.0.3",
"info": {
"title": "trocco APIリファレンス",
"description": "trocco APIリファレンス",
"version": "0.0.1"
},
"servers": [
{
"url": "https://trocco.io"
}
],
"security": [
{
"ApiKeyAuth": []
}
],
"tags": [
{
"name": "users",
"description": "ユーザー",
"externalDocs": {
"url": "https://documents.trocco.io/docs/about-account-user"
}
},
{
"name": "teams",
"description": "チーム",
"externalDocs": {
"url": "https://documents.trocco.io/docs/team"
}
},
{
"name": "connections",
"description": "接続情報",
"externalDocs": {
"url": "https://documents.trocco.io/docs/connection-configurations"
}
},
{
"name": "custom_connectors",
"description": "カスタムコネクタ定義"
},
{
"name": "datamart_definitions",
"description": "データマート定義",
"externalDocs": {
"url": "https://documents.trocco.io/docs/data-mart"
}
},
{
"name": "environment_groups",
"description": "環境グループ"
},
{
"name": "environments",
"description": "環境"
},
{
"name": "jobs",
"description": "転送ジョブ",
"externalDocs": {
"url": "https://documents.trocco.io/docs/etl-configuration"
}
},
{
"name": "pipeline_jobs",
"description": "ワークフロージョブ",
"externalDocs": {
"url": "https://documents.trocco.io/docs/about-workflow"
}
},
{
"name": "resource_groups",
"description": "リソースグループ",
"externalDocs": {
"url": "https://documents.trocco.io/docs/resource-group"
}
},
{
"name": "dbt_git_repositories",
"description": "dbt Gitリポジトリ"
},
{
"name": "dbt_job_definitions",
"description": "dbtジョブ設定",
"externalDocs": {
"url": "https://documents.trocco.io/docs/dbt-job-configuration"
}
},
{
"name": "dbt_jobs",
"description": "dbtジョブ",
"externalDocs": {
"url": "https://documents.trocco.io/docs/dbt-job-configuration"
}
},
{
"name": "notification_destinations",
"description": "通知先",
"externalDocs": {
"url": "https://documents.trocco.io/docs/trocco-tutorial-additional-settings"
}
}
],
"externalDocs": {
"description": "trocco APIについて",
"url": "https://documents.trocco.io/docs/trocco-api"
},
"paths": {
"/api/datamart_jobs": {
"post": {
"summary": "データマートジョブ実行\n",
"description": "データマートジョブを実行します。
\n",
"operationId": "createDatamartJob",
"tags": [
"datamart_jobs"
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"datamart_definition_id": {
"description": "データマートジョブを実行するデータマート定義のID",
"type": "integer",
"format": "int64",
"example": 42
},
"context_time": {
"description": "転送設定でカスタム変数 時刻・日付（キューイング時） を利用する場合、展開される日時を指定します。
\n未指定の場合、APIリクエストが送信された日時が展開されます。タイムゾーンには`time_zone`の値が使用されます。
\n`custom_variables`が指定された場合は無視されます。\n",
"type": "string",
"example": "2023-05-19 00:00:00"
},
"time_zone": {
"description": "タイムゾーンを指定します。
\n`context_time`で指定する日時に適用されます。指定できる値は、[タイムゾーン（time_zone）](https://documents.trocco.io/trocco-api/apidocs/overview#%E3%82%BF%E3%82%A4%E3%83%A0%E3%82%BE%E3%83%BC%E3%83%B3%EF%BC%88timezone%EF%BC%89)を参照ください。
\n`context_time`が指定されなかった場合は無視されます。\n",
"type": "string",
"default": "Asia/Tokyo",
"example": "Etc/UTC"
},
"memo": {
"type": "string",
"description": "任意のテキストを指定します。",
"example": "実行したデータマートジョブに関する補足など〜"
},
"custom_variables": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"description": "カスタム変数の変数名を指定します。変数名を`$`で囲ってください。
\n[複数のカスタム変数を指定する](https://documents.trocco.io/trocco-api/apidocs/overview#%E3%82%AB%E3%82%B9%E3%82%BF%E3%83%A0%E5%A4%89%E6%95%B0%E3%82%92%E8%A4%87%E6%95%B0%E6%8C%87%E5%AE%9A%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95)ことができます。\n",
"type": "string",
"example": "$companyId$"
},
"value": {
"description": "直前に指定したカスタム変数に展開する値を指定します。
\n[複数のカスタム変数を指定する](https://documents.trocco.io/trocco-api/apidocs/overview#%E3%82%AB%E3%82%B9%E3%82%BF%E3%83%A0%E5%A4%89%E6%95%B0%E3%82%92%E8%A4%87%E6%95%B0%E6%8C%87%E5%AE%9A%E3%81%99%E3%82%8B%E6%96%B9%E6%B3%95)ことができます。\n",
"type": "string",
"example": "c-12345"
}
}
}
}
},
"required": [
"datamart_definition_id"
]
}
}
}
},
"responses": {
"200": {
"description": "実行したデータマートジョブの情報を返却します。",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"id": {
"description": "データマートジョブIDです。",
"type": "integer",
"format": "int64",
"example": 123
},
"datamart_definition_id": {
"description": "データマート定義IDです。",
"type": "integer",
"format": "int64",
"example": 321
},
"context_time": {
"description": "転送設定でカスタム変数 時刻・日付（キューイング時） を利用した場合に展開された日時を指定します。
\nリクエスト時に`context_time`を指定した場合、その値が返却されます。\n",
"type": "string",
"example": "2023-05-19 00:00:00"
}
}
}
}
}
},
"400": {
"description": "Bad request.
\n不正なリクエストです。\n"
},
"401": {
"description": "Not authenticated.
\n認証エラーです。API KEYをご確認ください。\n"
}
}
}
}
},
"components": {
"securitySchemes": {
"ApiKeyAuth": {
"type": "apiKey",
"in": "header",
"name": "Authorization",
"description": "認証キーとなるAPI KEYをAuthorization: Token {{API KEY}}の形式でヘッダーにセットします。
\nAPI KEYがabc123の場合は、Authorization: Token abc123とします。
\nAPI KEYの作成方法は、TROCCO API KEYの作成を参照ください。\n"
}
}
}
}
````