{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-@l10n/ja/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"MariaDB インポート連携","description":"MariaDBからTreasure AIへのデータインポート方法を解説。コマンドラインツールを使用し、設定ファイルの作成とデータ連携の手順を詳しく説明します。","siteUrl":"https://docs.treasure.ai","lang":"en-US","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://www.treasure.ai/","name":"Treasure AI","url":"https://www.treasure.ai/","logo":"https://www.treasure.ai/hubfs/assets/images/logos/primary-logo.svg"},{"@type":"WebSite","@id":"https://docs.treasure.ai/#website","name":"Treasure AI Documentation","url":"https://docs.treasure.ai/","inLanguage":["en","ja"],"publisher":{"@id":"https://www.treasure.ai/"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"mariadb-インポート連携","__idx":0},"children":["MariaDB インポート連携"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["この記事では、MariaDBからTreasure Dataに直接データをインポートできるMariaDB用データコネクターの使用方法について説明します。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"前提条件","__idx":1},"children":["前提条件"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treasure Dataの基本知識"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["MariaDBの基本知識"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Treasure Dataコマンドラインの基本知識"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"コマンドラインの使用","__idx":2},"children":["コマンドラインの使用"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"td-toolbelt-v0119以降のインストール","__idx":3},"children":["TD Toolbelt v0.11.9以降のインストール"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["最新の",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://toolbelt.treasuredata.com/"},"children":["TD Toolbelt"]},"をインストールできます。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"$ td --version\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"設定ファイルの作成","__idx":4},"children":["設定ファイルの作成"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["以下の例のように、MariaDBアカウントのアクセス情報を含む設定ファイル（例：",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["seed.yml"]},"）を準備します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"in:\n  type: mysql\n  host: \"hostname\"\n  port: 3306\n  user: \"myuser\"\n  password: \"mypassword\"\n  database: \"mydatabasename\"\n  table: \"mytablename\"\n  select: \"*\"\nout:\n  mode: replace\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"フィールドの推測loadymlの生成","__idx":5},"children":["フィールドの推測（load.ymlの生成）"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["connector:guess"]},"を使用します。このコマンドは、対象ファイルを自動的に読み取り、ファイル形式を賢く推測します。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"$ td connector:guess seed.yml -o load.yml\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["load.yml"]},"を開くと、ファイル形式、エンコーディング、カラム名、型などを含む、推測されたファイル形式の定義が表示されます。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"yaml","header":{"controls":{"copy":{}}},"source":"in:\n  {type: mysql,host: \"hostname\",port: 3306,user: \"myuser\",password: \"mypassword\",  database: \"mydatabasename\", table: \"mytablename\",select: \"*\"}\nfilters: []\nout: {mode: replace}\nexec: {}\n","lang":"yaml"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"インポートするデータのプレビュー","__idx":6},"children":["インポートするデータのプレビュー"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td connector:preview"]},"コマンドを使用して、インポートされるデータをプレビューできます。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ td connector:preview maria_import.yml\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ロードジョブの実行","__idx":7},"children":["ロードジョブの実行"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ロードジョブを送信します。データサイズによっては数時間かかる場合があります。ユーザーは、データが保存されるデータベースとテーブルを指定する必要があります。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treasure Dataのストレージは時間でパーティション分割されているため、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--time-column"]},"オプションを指定することをお勧めします（",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-zgraveyard/data-partitioning-in-treasure-data"},"children":["データパーティショニング"]},"も参照してください）。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["このオプションが指定されていない場合、データコネクターは最初の",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["long"]},"または",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["timestamp"]},"カラムをパーティショニング時間として選択します。",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--time-column"]},"で指定するカラムの型は、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["long"]},"または",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["timestamp"]},"のいずれかである必要があります。"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["データに時間カラムがない場合は、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["add_time"]},"フィルターオプションを使用して追加できます。詳細は",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/add_time-filter-function"},"children":["add_timeフィルタープラグイン"]},"を参照してください。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"td connector:issue maria_import.yml \\\n--database td_sample_db \\\n--table td_mariadb_table \\\n--time-column created_at\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["上記のコマンドは、",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["データベース(td_sample_db)"]}," と ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["テーブル(td_maria_table)"]}," が既に作成されていることを前提としています。データベースまたはテーブルがTDに存在しない場合、このコマンドは成功しません。したがって、",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.treasuredata.com/smart/project-product-documentation/data-management"},"children":["データベースとテーブルを手動で作成"]},"するか、",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td connector:issue"]},"コマンドで",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--auto-create-table"]},"オプションを使用してデータベースとテーブルを自動作成してください。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"td connector:issue maria_import.yml \\\n--database td_sample_db \\\n--table td_mariadb_table \\\n--auto-create-table -w\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"スケジュール実行","__idx":8},"children":["スケジュール実行"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["定期的なMariaDBインポートのために、定期的なデータコネクターの実行をスケジュールできます。Treasure Dataのスケジューラーの負荷分散と動作は、高可用性を実現するように最適化されています。Treasure Dataのスケジューラーを使用することで、ローカルデータセンターにcronデーモンを配置する必要がなくなります。"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"スケジュールの作成","__idx":9},"children":["スケジュールの作成"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["td connector:create"]},"コマンドを使用して、新しいスケジュールを作成できます。スケジュールの名前、cron形式のスケジュール、データが保存されるデータベースとテーブル、およびデータコネクター設定ファイルを指定します。これらの値は必須です。"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"$ td connector:create \\\n    daily_mariadb_import \\\n    \"10 0 * * *\" \\\n    td_sample_db \\\n    td_mariadb_table \\\n    load.yml\n"},"children":[]},{"$$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"]},"の3つのオプションも受け入れます。"]},{"$$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":"em","attributes":{},"children":["サポートされておらず"]},"、予期しないスケジュールになる可能性があります。"]}]},"headings":[{"value":"MariaDB インポート連携","id":"mariadb-インポート連携","depth":1},{"value":"前提条件","id":"前提条件","depth":2},{"value":"コマンドラインの使用","id":"コマンドラインの使用","depth":2},{"value":"TD Toolbelt v0.11.9以降のインストール","id":"td-toolbelt-v0119以降のインストール","depth":3},{"value":"設定ファイルの作成","id":"設定ファイルの作成","depth":3},{"value":"フィールドの推測（load.ymlの生成）","id":"フィールドの推測loadymlの生成","depth":3},{"value":"インポートするデータのプレビュー","id":"インポートするデータのプレビュー","depth":3},{"value":"ロードジョブの実行","id":"ロードジョブの実行","depth":3},{"value":"スケジュール実行","id":"スケジュール実行","depth":3},{"value":"スケジュールの作成","id":"スケジュールの作成","depth":3}],"frontmatter":{"seo":{"title":"MariaDB インポート連携","description":"MariaDBからTreasure AIへのデータインポート方法を解説。コマンドラインツールを使用し、設定ファイルの作成とデータ連携の手順を詳しく説明します。"}},"lastModified":"2026-06-17T07:22:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ja/int/mariadb-import-integration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}