サマリ
モザイク データセットを最新の状態に維持します。データの同期だけでなく、元になる画像が変更された場合のオーバービューの更新、新しいオーバービューとキャッシュの生成、モザイク データセット アイテムの元の構成の復元が可能です。このツールでソース データのパスを削除することもできます。パスを修正するには、[モザイク データセット パスの修正 (Repair Mosaic Dataset Paths)] ツールを使用する必要があります。
同期は一方向の操作で、ソース データの変更をモザイク データセットの属性テーブルに同期させ、モザイク データセットの属性テーブルを更新することができます。モザイク データセットの属性テーブルの変更は、ソース データには影響を与えません。
使用法
このツールと一緒に選択セットを使用して、更新されるラスター アイテムを制限することができます。選択セットまたはクエリがある場合、それらのアイテムだけが処理されます。
同期では、新しいアイテムの追加、既存アイテムの更新、アイテムの削除ができます。
古くなったアイテムとは、モザイク データセットが作成されてから、またはモザイク データセットが最後に同期されてから変更されたソース ラスターを指します。たとえば、ジオリファレンスが更新されたり、ピラミッドが構築されたりする可能性があります。
ラスター アイテムは再構築されるため、最後に構築されてから加えられたこれらのアイテムに対する変更 (属性テーブル内の関数やコンテンツの編集など) は失われます。
リンクの切れたデータ ソースを持つアイテムを削除する場合は、すべてのネットワーク接続が正しく動作していることを確認してください。このツールは、アクセスできないすべてのアイテムを削除します。
また、このツールを使用して、ピラミッドの構築、ソース ラスターの統計情報の計算、ラスター アイテムのサムネイルとラスター キャッシュの作成もできます。
このツールは、モザイク データセットを最新の状態に保つ場合に、特に便利です。そのモザイク データセットがアクセスするワークスペースに新しいラスター データセットが追加された場合、その新しいラスター データセットをモザイク データセットに追加できます。外部管理のデータベースにあるテーブルを使って設定されたモザイク データセットを、このツールを使って更新することもできます。
同期が完了すると、[モザイク データセット オプション] にリストされた操作 (Python の update_cellsize_ranges、update_boundary、および update_overviews パラメーター) が実行されます。
このツールを使用して、モザイク データセット内のアイテムにキャッシュを生成することができます。LAS ファイル、LAS データセット、テレインの各データから作成されるアイテムは、必ずキャッシュできます。また、ラスター キャッシュ関数を使用してアイテムをキャッシュすることもできます。
データベースの断片化や頻繁なデータ操作によって、モザイク データセットのサイズが急激に増加する場合があります。定常的なトランザクションによってデータベースのサイズが増加した場合は、[最適化 (Compact)] ツールを実行してください。
構文
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}, {refresh_aggregate_info})| パラメータ | 説明 | データ タイプ |
in_mosaic_dataset | 同期するモザイク データセット。 | Image Service; Mosaic Layer; String |
where_clause (オプション) | どのモザイク データセット アイテムを同期するかを選択する SQL 式。式が指定されていない場合は、すべてのデータセット アイテムが更新されます。 | SQL Expression |
new_items (オプション) | 同期の際に新しいアイテムを含めるかどうかを選択して、新しいアイテムを更新するオプションを指定します。 このオプションを選択した場合、アイテムのワークスペースから新しいデータを検索します。データがモザイク データセットに追加されると、そのモザイク データセットは、同じワークスペース内の他のアイテムと同じラスター タイプを使用します。
| Boolean |
sync_only_stale (オプション) | 同期によって元になるラスター データセットが変更されたモザイク データセット アイテムを更新するかどうかを選択します。たとえば、ピラミッドの構築やラスターのジオリファレンスの更新は、オーバービューのレンダリングの方法に影響を与えます。
| Boolean |
update_cellsize_ranges (オプション) | セル サイズ範囲を更新するかどうかを選択します。
| Boolean |
update_boundary (オプション) | 境界線を更新するかどうかを選択します。
| Boolean |
update_overviews (オプション) | 古くなったオーバービューを更新するかどうかを選択します。同期によって元になるラスターが変更された場合、オーバービューは古くなります。
| Boolean |
build_pyramids (オプション) | 指定されたモザイク データセット アイテムのピラミッドを構築するかどうかを選択します。モザイク データセットのラスター アイテムごとにピラミッドを構築できます。ピラミッドは、各ラスターが表示される速度を向上します。
同期によって追加されたアイテムのピラミッドは構築しません。 | Boolean |
calculate_statistics (オプション) | 指定されたモザイク データセット アイテムの統計情報を計算するかどうかを選択します。コントラスト ストレッチの適用などの特定のタスクを実行するには、モザイク データセットに統計情報が必要です。
同期によって追加されたアイテムの統計情報は構築しません。 | Boolean |
build_thumbnails (オプション) | 指定されたモザイク データセット アイテムのサムネイルを構築するかどうかを選択します。サムネイルは小さなサイズにリサンプリングされた画像で、モザイク定義に含まれるラスター アイテムごとに作成できます。サムネイルは、モザイク データセットがイメージ サービスとしてアクセスされた場合にアクセス可能で、アイテム説明の一部として表示されます。
同期によって追加されたアイテムのサムネイルは構築されません。 | Boolean |
build_item_cache (オプション) | 指定されたモザイク データセット アイテムのキャッシュを構築するかどうかを選択します。キャッシュは、LAS、テレイン、LAS データセットの各ラスター タイプを使用してデータを追加したときに作成できます。また、ラスター キャッシュ関数を使用してアイテムをキャッシュすることもできます。
同期によって追加されたアイテムのキャッシュは構築されません。 | Boolean |
rebuild_raster (オプション) | 元のラスター タイプを使用してラスター アイテムをデータ ソースから再構築するかどうかを選択します。
これは、同期されるアイテムだけに影響します。new_items パラメーターが UPDATE_WITH_NEW_ITEMS に設定されている場合、このパラメーターは適用されません。 | Boolean |
update_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_stale、build_pyramids、calculate_statistics、build_thumbnails、build_item_cache、update_fields、または fields_to_update。
| Boolean |
broken_items (オプション) | 切れたリンクを削除するかどうかを選択します。 すべてのネットワーク接続が正しく動作していることを確認してください。このツールは、アクセスできないすべてのアイテムを削除します。
| Boolean |
skip_existing_items (オプション) | new_items パラメーターで UPDATE_WITH_NEW_ITEMS を指定すると、既存のモザイク データセット アイテムをスキップするか、またはディスクの変更されたファイルで更新するかを選択できます。
| Boolean |
refresh_aggregate_info (オプション) | モザイク データセットから削除された可能性のあるデータをもう一度追加するかどうかを選択します。
| 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: ○