Azure Cosmos DB のバックアップ

1ダウンロード

GitHub の Releases から最新版をダウンロードします（図2）。

図2 Data Migration Tool のダウンロード

2設定ファイル（migrationsettings.json）の編集

zip を解凍したフォルダに設定ファイル（migrationsettings.json）があります。
ここに入出力の設定を記述します。

Source ➜ Sink の方向にデータが出力されます。

以下は Cosmos DB（Cosmos-NoSql） からローカル PC の json ファイルに出力する例です。

{
    "Source": "Cosmos-NoSql",
    "Sink": "JSON",
    "SourceSettings":
    {
        "ConnectionString": "AccountEndpoint=https://<Cosmos DBアカウント名>.documents.azure.com:443/;AccountKey=<アカウントキー>;",
        "Database":"<データベース名>",
        "Container":"<コンテナ名>",
        "IncludeMetadataFields": true
    },
    "SinkSettings":
    {
        "FilePath": "output.json",
        "Indented": true
    }
}

3実行

dmt.exe

カレントディレクトリに output.json が出力されます。

1Azure Data Factory（ADF）を作成

ポータルから Data Factory (V2) を選択します（図3）。
（日本語では「データ ファクトリ」です）

図3 Data Factory (V2)を選択

「作成」ボタンをクリックして「データ ファクトリの作成」画面に進みます（図４）。

図4 データ ファクトリの作成

• リソースグループ
• 名前
• リージョン

をそれぞれ選択、入力してください。
バージョンは「V2」を選択し、「確認と作成」をクリックしてデータファクトリを作成します。

2Cosmos DB のリンクサービスを作成

作成したデータファクトリから「スタジオの起動」をクリックします（図5）。

図5 「スタジオの起動」をクリック

管理 > リンク サービス > リンク サービスを作成 をクリックします（図6）。

図6 リンク サービスを作成

Azure Cosmos DB for NoSQL を選択して「続行」をクリックします（図7）。

図7 Azure Cosmos DB for NoSQL を選択

名前に任意の識別名をつけて、Cosmos DB の接続情報を選択し、「作成」をクリックします（図8）。

図8 新しいリンクサービス

3Blob Storage のリンクサービスを作成

Cosmos DB の場合と同様に、リンクサービスの新規作成 >「Azure BLOB ストレージ」を選択 > 「続行」をクリックします（図9）。

図9 新しいリンク サービス

名前に任意の識別名をつけて、Blob Storage の接続情報を選択し、「作成」をクリックします（図10）。

図10 新しいリンク サービスを作成

4Cosmos DB のデータセットを作成

次に Cosmos DB のデータセットを作成します。

作成（鉛筆マーク） > データセット > 新しいデータセット を選択します（図11）。

図11

「Azure Cosmos DB for NoSQL」を選択して、「続行」をクリックします（図12）。

図12 新しいデータセット

リンクサービスに 2. で作成した Cosmos DB のリンクサービスを選択し、出力元となるコンテナーを選択します（図13）。

図13 プロパティの設定

5Blob Storage のデータセットを作成

Cosmos DB と同様に Blob Storage のデータセットを作成します。

作成（鉛筆マーク） > データセット > 新しいデータセット >「Azure BLOB ストレージ」を選択して、「続行」をクリックします（図14）。

図14 新しいデータセット

「JSON」を選択し、「続行」をクリックします（図15）。

図15 形式の選択

• リンクサービス
  作成した Blob Storage のリンクサービスを選択します。

• ファイル パス
  出力先のファイルパスになります。

• スキーマのインポート
  「なし」を選択します。

「OK」をクリックします（図16）。

図16

6パイプラインの作成

Cosmos DB から Blob Storage へデータをコピーするパイプラインを作成します。

作成 >パイプライン > 新しいパイプライン を選択します（図17）。

図17

アクティビティから「データのコピー」をドラッグします（図18）。

図18 「データのコピー」をドラッグ

「ソース」タブで Cosmos DB のデータセットを選択します（図19）。

図19 ソースに Cosmos DB のデータセットを選択

「シンク」タブで Blob Storage のデータセットを選択します（図20）。

図20 シンクに Blob Storage のデータセットを選択

ここで「すべて発行」をクリックして作成を確定します（図21、図22）。発行を行わなかった場合、作成したデータセットとパイプラインはブラウザを閉じると消えてしまうので注意してください。（リンクサービスは残ります）

図21 すべて発行

図22 発行

7パイプラインの実行

「デバッグ」をクリックするとデバッグが開始されます（図23）。

図23

しばらく待つと以下のように実行結果が表示されます（図24）。

図24

8JSON をダウンロード

出力先に指定した Blob Storage のコンテナー/ディレクトリーに移動します。
ファイルが作成されているので、コンテキストメニューから「ダウンロード」を選択します（図25）。

図25

@concat('output_', formatDateTime(utcNow(), 'yyyyMMddHHmmss'), '.json')

SELECT * FROM c