概要
入力データのコピーを作成します。
使用法
フィーチャクラスをフィーチャ データセットにコピーする場合は、フィーチャクラスとフィーチャ データセットの空間参照が一致している必要があります。一致していない場合、ツールが失敗します。
入力に依存するデータもすべてコピーされます。たとえば、リレーションシップ クラスに含まれるフィーチャクラスまたはテーブルをコピーすると、そのリレーションシップ クラスもコピーされます。フィーチャクラスにフィーチャリンク アノテーション、ドメイン、サブタイプ、およびインデックスがある場合も同様です。これらはすべてフィーチャクラスとともにコピーされます。ジオメトリック ネットワーク、ネットワーク データセット、およびトポロジをコピーすると、関連のあるフィーチャクラスもコピーされます。
レイヤーは、フィーチャクラスへの参照にすぎないため、[コピー (Copy)] ツールによってコピーされません。
モザイク データセットをコピーすると、モザイク データセットが指定した場所にコピーされます。モザイク データセットが参照する画像はコピーされません。
[コピー (Copy)] ツールは *.mrf 画像形式をサポートしていません。*.mrf ファイルをコピーするには、[ラスターのコピー (Copy Raster)] ツールを使用します。
入力に関連データがあるとき、関連する出力データの名前とコンフィグレーション キーワードを制御できる場合に [関連データ] パラメーターが表示されます。
構文
Copy(in_data, out_data, {data_type}, {associated_data})| パラメーター | 説明 | データ タイプ |
in_data | コピーされるデータ。 | Data Element |
out_data | 出力データの場所および名前。出力データのファイル名の拡張子は、入力データの拡張子と一致する必要があります。たとえば、ファイル ジオデータベースをコピーしている場合、出力データ エレメントの拡張子は「*.gdb」である必要があります。 | Data Element |
data_type (オプション) | コピーするディスク上のデータのタイプ。これは、入力データがジオデータベース内にあり、名前の競合が存在する場合 (同じ名前のフィーチャ データセットとフィーチャクラスがジオデータベースに含まれている場合など) にのみ必要です。この場合、コピーするデータセットを明確にするために、データ タイプが使用されます。 | String |
associated_data [[from_name, data_type, to_name, config_keyword],...] (オプション) | 入力に関連データがあるとき、このパラメーターを使用して、関連する出力データの名前とコンフィグレーション キーワードを制御できます。
from_name と to_name の列名は、to_name が out_data でまだ使用されていない場合は同じです。out_data に名前がすでに存在する場合、アンダースコアと数字 (_2) を追加した一意の to_name が作成されます。 | Value Table |
コードのサンプル
次の Python ウィンドウ スクリプトは、イミディエイト モードで Copy 関数を使用する方法を示しています。
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.Copy_management("majorrds.shp", "C:/output/majorrdsCopy.shp")次の Python スクリプトは、スタンドアロン スクリプトで Copy 関数を使用する方法を示しています。
# Name: Copy_Example2.py
# Description: Copy major roads dataset to preserve the original data
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/data"
# Set local variables
in_data = "majorrds.shp"
out_data = "C:/output/majorrdsCopy.shp"
# Execute Copy
arcpy.Copy_management(in_data, out_data)次の Python スクリプトは、associated_data 関数で Copy パラメーターを使用する方法を示しています。
# Name: Copy_Example3.py
# Description: Copy a feature dataset and specify associated_data
# Import system modules
import arcpy
# the input is a feature dataset containing 3 feature classes: lakes, cities, rivers
in_data = "C:/data/proj.gdb/mexico"
out_data = "C:/data/proj.sde/mexico"
# Rename each feature class during the copy operation using the associated_data parameter
arcpy.Copy_management(in_data, out_data, associated_data=";".join(["lakes FeatureClass mexico_lakes #",
"cities FeatureClass mexico_cities #",
"rivers FeatureClass mexico_rivers #"
]))ライセンス情報
- Basic: はい
- Standard: はい
- Advanced: はい