{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"CLIからのData Connectorジョブ実行のスケジュール設定","description":"Treasure Data Product Documentation · Collect and Unify · Segment and Activate · Experiment and Analyze · Decisioning Automate with AI Scale and Trust.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"cliからのdata-connectorジョブ実行のスケジュール設定","__idx":0},"children":["CLIからのData Connectorジョブ実行のスケジュール設定"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["スケジュール実行は、連携元からデータを取得する定期的な試行中のData Connectorの動作を制御する追加の設定パラメーターをサポートしています:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["incremental"]}," この設定は、ロードモードを制御するために使用されます。ロードモードは、各オブジェクトに関連付けられたネイティブのタイムスタンプまたは数値フィールドの1つに基づいて、Data Connectorが連携からデータを取得する方法を管理します"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["incremental_columnn"]}," この設定は、Treasure Dataにインポートされるベースカラムを定義するために使用されます。このフィールドには1つのカラムのみを定義できます。推奨値は ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["created, createdTimestamp, updated, updatedTimestamp"]}," です"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["PST、CSTなどのTimezoneの略語はサポートされておらず、予期しないスケジュールになる可能性があります。"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["--timezoneオプションは、'Asia/Tokyo'、'America/Los_Angeles'などの拡張Timezone形式のみをサポートしています。"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["incremental modeを使用したロードファイルの例を次に示します:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"in:\n  type: intg_type\n  data_center: US1\n  authentication_mode: key_secret\n  application_key: your_application_user_key\n  secret_key: your_application_secret_key\n  api_key: your_api_key\n  data_source: account\n  batch_size: 1000\n  query: SELECT * FROM table_name\n  incremental: true\n  incremental_column: created\nfilters:\n- type: add_time\n  from_value:\n    mode: upload_time\n  to_column:\n    name: time\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"スケジュールの作成","__idx":1},"children":["スケジュールの作成"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["新しいスケジュールは、td connector:createコマンドを使用して作成できます。スケジュールの名前、cron形式のスケジュール、データが保存されるdatabaseとtable、およびData Connector設定ファイルが必要です。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cron"]},"パラメーターは、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@hourly"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@daily"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@monthly"]},"のオプションを受け入れます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["デフォルトでは、スケジュールはUTC timezoneで設定されます。-tまたは--timezoneオプションを使用して、timezoneでスケジュールを設定できます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["たとえば、td connector:createコマンドを使用して日次で実行されるスケジュールジョブを作成できます:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"td connector:create connector_name @daily connector_database connector_table load.yml\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure Dataのストレージは時間でパーティション化されているため、",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["--time-column"]},"オプションを指定することもお勧めします（",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/data-partitioning-in-treasure-data"},"children":["data partitioning"]},"も参照）。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"td connector:create daily_import \"10 0 * * *\" \\\n    td_sample_db td_sample_table load.yml \\\n    --time-column created_at\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cron"]},"パラメータは、3つの特別なオプション:",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@hourly"]},"、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@daily"]},"、および",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@monthly"]},"も受け入れます。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["デフォルトでは、スケジュールはUTCタイムゾーンで設定されます。-tまたは--timezoneオプションを使用して、タイムゾーンでスケジュールを設定できます。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--timezone"]},"オプションは、'Asia/Tokyo'、'America/Los_Angeles'などの拡張タイムゾーン形式のみをサポートします。PST、CSTなどのタイムゾーンの略語はサポートされて*いません*。予期しないスケジュールになる可能性があります。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"すべてのスケジュールをリスト","__idx":2},"children":["すべてのスケジュールをリスト"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["td connector:list"]},"コマンドを実行することで、現在スケジュールされているエントリのリストを表示できます。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ td connector:list\n+--------------+--------------+----------+-------+--------------+-----------------+------------------------------------------+\n| Name         | Cron         | Timezone | Delay | Database     | Table           | Config                                   |\n+--------------+--------------+----------+-------+--------------+-----------------+------------------------------------------+\n| daily_import | 10 0 * * *   | UTC      | 0     | td_sample_db | td_sample_table | {\"in\"=>{\"type\"=>\"s3\", \"access_key_id\"... |\n+--------------+--------------+----------+-------+--------------+-----------------+------------------------------------------+\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"スケジュール設定と履歴の表示","__idx":3},"children":["スケジュール設定と履歴の表示"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["td connector:show"]},"は、スケジュールエントリの実行設定を表示します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"td connector:show daily_import\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Name     : daily_import\nCron     : 10 0 * * *\nTimezone : UTC\nDelay    : 0\nDatabase : td_sample_db\nTable    : td_sample_table\nConfig\n---\nin:\n  type: s3\n  access_key_id: access_key_id\n  secret_access_key: secret_access_key\n  endpoint: endpoint\n  bucket: bucket\n  path_prefix: path_prefix\n  parser:\n    charset: UTF-8\n    ...\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["td connector:history"]},"は、スケジュールエントリの実行履歴を表示します。個々の実行の結果を調査するには、",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["td job jobid"]},"を使用します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"td connector:history daily_import\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"+--------+---------+---------+--------------+-----------------+----------+---------------------------+----------+\n| JobID  | Status  | Records | Database     | Table           | Priority | Started                   | Duration |\n+--------+---------+---------+--------------+-----------------+----------+---------------------------+----------+\n| 578066 | success | 10000   | td_sample_db | td_sample_table | 0        | 2015-04-18 00:10:05 +0000 | 160      |\n| 577968 | success | 10000   | td_sample_db | td_sample_table | 0        | 2015-04-17 00:10:07 +0000 | 161      |\n| 577914 | success | 10000   | td_sample_db | td_sample_table | 0        | 2015-04-16 00:10:03 +0000 | 152      |\n| 577872 | success | 10000   | td_sample_db | td_sample_table | 0        | 2015-04-15 00:10:04 +0000 | 163      |\n| 577810 | success | 10000   | td_sample_db | td_sample_table | 0        | 2015-04-14 00:10:04 +0000 | 164      |\n| 577766 | success | 10000   | td_sample_db | td_sample_table | 0        | 2015-04-13 00:10:04 +0000 | 155      |\n| 577710 | success | 10000   | td_sample_db | td_sample_table | 0        | 2015-04-12 00:10:05 +0000 | 156      |\n| 577610 | success | 10000   | td_sample_db | td_sample_table | 0        | 2015-04-11 00:10:04 +0000 | 157      |\n+--------+---------+---------+--------------+-----------------+----------+---------------------------+----------+\n8 rows in set\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"スケジュールの削除","__idx":4},"children":["スケジュールの削除"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["td connector:delete"]},"は、スケジュールを削除します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ td connector:delete daily_import\n"},"children":[]}]},"headings":[{"value":"CLIからのData Connectorジョブ実行のスケジュール設定","id":"cliからのdata-connectorジョブ実行のスケジュール設定","depth":1},{"value":"スケジュールの作成","id":"スケジュールの作成","depth":2},{"value":"すべてのスケジュールをリスト","id":"すべてのスケジュールをリスト","depth":2},{"value":"スケジュール設定と履歴の表示","id":"スケジュール設定と履歴の表示","depth":2},{"value":"スケジュールの削除","id":"スケジュールの削除","depth":2}],"frontmatter":{"seo":{"title":"CLIからのData Connectorジョブ実行のスケジュール設定"}},"lastModified":"2025-12-23T04:19:16.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/int/scheduling-a-data-connector-job-execution-from-the-cli","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}