モザイク データセットの同期(Synchronize Mosaic Dataset) (データ管理)

ライセンス レベル:BasicStandardAdvanced

サマリ

モザイク データセット内の各ラスタ アイテムを再構築および更新し、初回追加時に使用されたラスタ タイプとオプションを使って、属性テーブル内の影響を受けるフィールドを更新します。

同期は一方通行の操作で、ソース データの変更をモザイク データセットの属性テーブルに同期させることはできますが、属性テーブルの変更はソース データに影響しません(ただし、同期によって上書きされる可能性はあります)。

注意注意:

同期により加えられる変更は、元に戻すことができません。上書きされる可能性のあるモザイク データに変更を加える場合は、バックアップ コピーを作成しておくことをお勧めします。

使用法

構文

SynchronizeMosaicDataset_management (in_mosaic_dataset, {where_clause}, {new_items}, {sync_only_stale}, {update_cellsize_ranges}, {update_boundary}, {update_overviews}, {build_pyramids}, {calculate_statistics}, {build_thumbnails}, {build_item_cache}, {rebuild_raster}, {update_fields}, {fields_to_update}, {existing_items}, {broken_items}, {skip_existing_items})
パラメータ説明データ タイプ
in_mosaic_dataset

モザイク データセットのパスおよび名前。

Image Service; Mosaic Layer; String
where_clause
(オプション)

SQL を使用して、どのモザイク データセットを同期するか定義できます。クエリが指定されていない場合、すべてのモザイク データセット アイテムが同期されます。

SQL Expression
new_items
(オプション)

モザイク データセットを、新しく追加したアイテムと同期させるかどうかを選択します。このオプションを選択した場合、アイテムのワークスペースから新しいデータを検索します。データがモザイク データセットに追加されると、そのモザイク データセットは、同じワークスペース内の他のアイテムと同じラスタ タイプを使用します。

新しいアイテムを使って更新する場合、必要に応じて、セル サイズ範囲、境界、オーバービューを更新するかどうか、および既存のアイテムをも更新するか選択できます。

  • NO_NEW_ITEMS新しいアイテムが存在しても追加しません。これはデフォルト設定です。
  • UPDATE_WITH_NEW_ITEMS既存のモザイク データセット アイテムが格納されているワークスペース内にある新しいアイテムを使用して、モザイク データセットを更新します。必要に応じて、skip_existing_items パラメータで OVERWRITE_EXISTING_ITEMS キーワードを使用して、既存のアイテムを変更することもできます。
Boolean
sync_only_stale
(オプション)

すべてのプライマリ アイテムを更新するか、古くなったプライマリ アイテムだけを更新するかを選択します。

アイテムが古くなったと見なされるのは、それに対応するラスタ値の構築に使用されたソース ファイルが、アイテムの作成後に変更された場合です。たとえば、ジオリファレンスが更新されたり、ピラミッドが構築されたりする可能性があります。

  • SYNC_STALE古くなったアイテムだけを更新します。これはデフォルト設定です。
  • SYNC_ALLモザイク データセットの選択したすべてのアイテムを更新します。
Boolean
update_cellsize_ranges
(オプション)

セル サイズ範囲を更新するかどうかを選択します。

  • UPDATE_CELL_SIZESモザイク データセット全体のセル サイズ範囲が再計算されますが、表示設定値が無効なアイテムだけが更新されます。これはデフォルト設定です。
  • NO_CELL_SIZES セル サイズ範囲は再計算されません。
Boolean
update_boundary
(オプション)

境界線を更新するかどうかを選択します。

  • UPDATE_BOUNDARY モザイク データセットが同期された後に、境界線が再構築されます。これはデフォルト設定です。
  • NO_BOUNDARY 境界線は再構築されません。
Boolean
update_overviews
(オプション)

古くなったオーバービューを更新するかどうかを選択します。元となるラスタが変更された場合、オーバービューは古くなります。

  • NO_OVERVIEWS オーバービューは再構築されません。これはデフォルト設定です。
  • UPDATE_OVERVIEWS モザイク データセットが同期された後に、影響を受けるオーバービューが再構築されます。
Boolean
build_pyramids
(オプション)

指定されたモザイク データセット アイテムのピラミッドを構築するかどうかを選択します。モザイク データセットのラスタ アイテムごとにピラミッドを構築できます。ピラミッドは、各ラスタが表示される速度を向上します。

  • NO_PYRAMIDSピラミッドを構築しません。これはデフォルト設定です。
  • BUILD_PYRAMIDS このツールで指定されたすべてのラスタ アイテムに対して、ピラミッドを構築します。

新しく追加されるアイテムがこのツールを実行しているのと同じインスタンスに追加される場合、そのアイテムのピラミッドは構築されません。

Boolean
calculate_statistics
(オプション)

指定されたモザイク データセット アイテムのソース ラスタについて、統計情報を計算するかどうかを選択します。コントラスト ストレッチの適用などの特定のタスクを実行するには、モザイク データセットに統計情報が必要です。

  • NO_STATISTICS統計情報は計算されません。これはデフォルト設定です。
  • CALCULATE_STATISTICS このツールで指定されたモザイク データセット アイテムのソース ラスタについて、統計情報が計算されます。

新しく追加されるアイテムがこのツールを実行しているのと同じインスタンスに追加される場合、そのアイテムの統計情報は計算されません。

Boolean
build_thumbnails
(オプション)

指定されたモザイク データセット アイテムのサムネイルを構築するかどうかを選択します。サムネイルは小さなサイズにリサンプリングされた画像で、モザイク定義に含まれるラスタ アイテムごとに作成できます。サムネイルにアクセスできるのは、モザイク データセットがイメージ サービスとしてアクセスされた場合であり、メタデータ(アイテムの説明)の一部として表示されます。

  • NO_THUMBNAILSサムネイルは作成または更新されません。これはデフォルト設定です。
  • BUILD_THUMBNAILSこのツールで指定されたすべてのラスタ アイテムに対して、サムネイルが作成されます。

新しく追加されるアイテムがこのツールを実行しているのと同じインスタンスに追加される場合、そのアイテムのサムネイルは構築されません。

Boolean
build_item_cache
(オプション)

指定されたモザイク データセット アイテムのキャッシュを構築するかどうかを選択します。キャッシュは、LAS、テレイン、LAS データセットの各ラスタ タイプを使用してデータを追加したときに作成できます。また、ラスタ キャッシュ関数を使用してアイテムをキャッシュすることもできます。

  • NO_ITEM_CACHEキャッシュは作成または更新されません。これはデフォルト設定です。
  • BUILD_ITEM_CACHEこのツールで指定されたすべてのラスタ アイテムに対して、キャッシュが作成されます。

新しく追加されるアイテムがこのツールを実行しているのと同じインスタンスに追加される場合、そのアイテムのキャッシュは構築されません。

Boolean
rebuild_raster
(オプション)

元のラスタ タイプを使用してラスタ アイテムをデータ ソースから再構築するかどうかを選択します。

  • REBUILD_RASTERソース データからラスタを再構築します。モザイク データセット内にある選択したアイテムに加えた変更はすべて失われます。これはデフォルト設定です。
  • NO_RASTERラスタを再構築しません。update_fields が選択されている場合、その他のプライマリ フィールドはリセットされます。

これは、同期されるアイテムだけに影響します。UPDATE_WITH_NEW_ITEMS が選択されている場合、このパラメータは適用されません。

Boolean
update_fields
(オプション)

テーブル内のフィールドを更新するかどうかを選択します。これは、同期されるアイテムだけに影響します。

  • UPDATE_FIELDSソース ファイルからフィールドを更新します。これはデフォルト設定です。
  • NO_FIELDSソースからテーブル内のフィールドをリセットしません。

フィールドを更新する場合、fields_to_update パラメータでアイテムを選択することで、更新するフィールドを制御することができます。いくつかのフィールドを編集した場合、fields_to_update パラメータでそれらの選択を解除できます。

Boolean
fields_to_update
[field_to_update,...]
(オプション)

更新するフィールドを指定します。

このパラメータは、[update_fields] パラメータのオプションが UPDATE_FIELDS の場合のみ有効になります。

いくつかのフィールドを編集した場合、それらがリストされていないことを確認します。

RASTER 列は、REBUILD_RASTER キーワードが使用されていない場合でも更新できます。ただし、REBUILD_RASTER が使用されている場合、RASTER 列はこのフィールドが指定されていない場合でも再構築されます。

String
existing_items
(オプション)

モザイク データセット内の既存のアイテムを更新するかどうかを選択します。

このオプションを選択した場合、既存のどのパラメータを更新するか次のうちから選択できます。sync_only_stalebuild_pyramidscalculate_statisticsbuild_thumbnailsbuild_item_cacheupdate_fields、または fields_to_update

  • UPDATE_EXISTING_ITEMS更新に選択したパラメータを使用して、既存のアイテムを更新します。これはデフォルト設定です。
  • IGNORE_EXISTING_ITEMS既存のアイテムを更新しません。
Boolean
broken_items
(オプション)

切れたリンクを削除するかどうかを選択します。

すべてのネットワーク接続が正しく動作していることを確認してください。このツールは、アクセスできないすべてのアイテムを削除します。

  • IGNORE_BROKEN_ITEMS切れたリンクを持つアイテムをモザイク データセットから削除しません。これはデフォルト設定です。
  • REMOVE_BROKEN_ITEMS切れたリンクを持つアイテムをモザイク データセットから削除します。
Boolean
skip_existing_items
(オプション)

UPDATE_WITH_NEW_ITEMS キーワードを使用すると、既存のモザイク データセット アイテムをスキップするか、それともディスクの変更されたファイルで更新するかどうかを選択できます。

  • SKIP_EXISTING_ITEMS新しいモザイク データセット アイテムを追加している間、ツールは既存のモザイク データセット アイテムを更新しません。これはデフォルト設定です。
  • OVERWRITE_EXISTING_ITEMS新しいモザイク データセット アイテムを追加している間、ツールは、ディスク上の変更されたファイルに該当する既存のモザイク データセット アイテムを更新します。
Boolean

コードのサンプル

SynchronizeMosaicDataset(モザイク データセットの同期)の例 1(Python ウィンドウ)

これは SynchronizeMosaicDataset(モザイク データセットの同期)の Python サンプルです。

import arcpy
arcpy.SynchronizeMosaicDataset_management(
    "c:/data/syncmd.gdb/md", "Year>1999", "NO_NEW_ITEMS", "SYNC_STALE",
    "#", "#", "#", "NO_PYRAMIDS", "NO_STATISTICS", "NO_THUMBNAILS", 
    "NO_ITEM_CACHE", "NO_RASTER", "NO_FIELDS", "#", "#")
SynchronizeMosaicDataset(モザイク データセットの同期)の例 2(スタンドアロン スクリプト)

これは SynchronizeMosaicDataset(モザイク データセットの同期)の Python スクリプト サンプルです。

# Synchronize source and add new data

import arcpy
arcpy.env.workspace = "C:/Workspace"

mdname = "syncmd.gdb/mdnew"
query = "#"
updatenew = "UPDATE_WITH_NEW_ITEMS"
syncstale = "SYNC_STALE"
updatecs = "#"
updatebnd = "#"
updateovr = "#"
buildpy = "NO_PYRAMIDS"
calcstats = "NO_STATISTICS"
buildthumb = "NO_THUMBNAILS"
buildcache = "NO_ITEM_CACHE"
updateras = "NO_RASTER"
updatefield = "NO_FIELDS"
fields = "#"

arcpy.SynchronizeMosaicDataset_management(
    mdname, query, updatenew, syncstale, updatecs, updatebnd, 
    updateovr, buildpy, calcstats, buildthumb, buildcache,
    updateras, updatefield, fields)

環境

関連トピック

ライセンス情報

ArcGIS for Desktop Basic: ×
ArcGIS for Desktop Standard: ○
ArcGIS for Desktop Advanced: ○
7/28/2014