---
title: 07.Mashu CLIでメタデータを同期する
description: Mashu CLIを使ってコマンドラインからメタデータ同期を実行する方法を解説します。
---

[サポートセンター | Data Fabric | PSC INC.](https://www.data-fabric.jp/blog-kb)

# [07.Mashu CLIでメタデータを同期する](https://www.data-fabric.jp/blog-kb/server/mashu-cli)

 作成者: [T](https://www.data-fabric.jp/blog-kb/author/t)｜2026/02/28 2:33:23

Mashu CLIはMashuのメタデータ同期をコマンドラインから呼び出すことができるツールです。

Mashu CLIを利用するとスクリプトからメタデータを同期したり、スケジューラーと組み合わせて定期的に同期ジョブを実行することができます。

 

### インストール方法

Mashuにログインしたあと、ユーザー設定ページのMashuサーバー/CLIタブからダウンロードできます。

### 基本的な使い方

#### 事前準備

Mashu CLIはMashuサーバーと連携して動作します。[こちら](https://services.robon.co.jp/ja/kb/mashu/server/mashu-server)を参考にMashuサーバーを起動してください。

[オンプレミス用のMashuサーバーについて](https://services.robon.co.jp/ja/kb/mashu/server/mashu-server)

ネットワーク通信要件（ファイアーウォール設定）

Mashu CLI は、外部サービスとの通信を必要とするため、以下の宛先およびポートに対して通信を許可してください。

| 宛先URL（ドメイン） | ポート番号 | プロトコル |
| --- | --- | --- |
| cognito-identity.ap-northeast-1.amazonaws.com | 443 | HTTPS |

#### メタデータを同期する

`sync`コマンドを使ってメタデータを同期できます。メタデータ同期の実行権限をもつユーザーを指定して実行してください。

```
$ ./mashu sync -username [ユーザー名] -password [パスワード] -endpoint [Mashuサーバーのエンドポイント] -org-id [ユーザーが所属する組織のID] -source-id [同期を実行するデータソースのID]
```

 

**例**

```
$ ./mashu sync -endpoint https://123.45.678.9:3000 -org-id xxxxx -source-id xxxxx -username robon -password xxxxx
```

#### ユーザーがMFAを設定している場合は、IDトークン, リフレッシュトークンの値をつかって実行できます。トークンの発行方法は[こちらの記事](https://www.data-fabric.jp/ja/kb/mashu/mashu%E3%81%A8api%E3%81%A7%E9%80%A3%E6%90%BA%E3%81%99%E3%82%8B)を参考ください。

```
$ ./mashu sync -endpoint https://123.45.678.9:3000 -org-id xxxxx -source-id xxxxx -id-token xxxx -refresh-token xxxxx
```

#### メタデータの同期結果を取得する

`status`コマンドでメタデータの同期結果を取得できます。

 

**例**

```
// -asyncオプションをつけて同期ジョブ実行後すぐにCLIを終了する$ ./mashu sync -username robon -password xxxxx -endpoint https://123.45.678.9:3000 -org-id xxxxx -source-id xxxxx -async// statusコマンドで同期結果を取得する$ ./mashu status -endpoint https://123.45.678.9:3000 -org-id xxxxx -source-id xxxxx -username robon -password xxxxx// MFAを設定している場合 $ ./mashu status -endpoint https://123.45.678.9:3000 -org-id xxxxx -source-id xxxxx-id-token xxxx -refresh-token xxxxx
```

#### ヘルプを確認する

helpコマンドでMashu CLIのヘルプを表示できます。

```
$ ./mashu help
```

 

```
  
```

[完全な記事を表示](https://www.data-fabric.jp/blog-kb/server/mashu-cli)

```json
{
  "@context" : "http://schema.org",
  "@type" : "BlogPosting",
  "author" : {
    "@type" : "Person",
    "name" : "T"
  },
  "dateModified" : "2026-04-22T01:22:59.292Z",
  "datePublished" : "2026-02-28T02:33:23Z",
  "headline" : "07.Mashu CLIでメタデータを同期する",
  "image" : {
    "@type" : "ImageObject",
    "height" : 635,
    "url" : "https://40029765.fs1.hubspotusercontent-na1.net/hubfs/40029765/Mashu/mashu_cli_howto_1.png",
    "width" : 896
  },
  "mainEntityOfPage" : "https://www.data-fabric.jp/blog-kb/server/mashu-cli",
  "publisher" : {
    "@type" : "Organization",
    "logo" : {
      "@type" : "ImageObject",
      "height" : 60,
      "url" : "/hs/hsstatic/content_shared_assets/static-1.4092/img/default-amp-logo.png",
      "width" : 60
    },
    "name" : "サポートセンター"
  }
}
```