コピー (Copy) (データ管理)

サマリー

入力データのコピーを作成します。

使用法

  • フィーチャクラスをフィーチャ データセットにコピーする場合は、フィーチャクラスとフィーチャ データセットの空間参照が一致している必要があります。一致していない場合、ツールが失敗します。

  • 入力に依存するデータもすべてコピーされます。 たとえば、リレーションシップ クラスに含まれるフィーチャクラスまたはテーブルをコピーすると、そのリレーションシップ クラスもコピーされます。 フィーチャクラスにフィーチャリンク アノテーション、ドメイン、サブタイプ、およびインデックスがある場合も同様です。これらはすべてフィーチャクラスとともにコピーされます。 ジオメトリック ネットワーク、ネットワーク データセット、およびトポロジをコピーすると、関連のあるフィーチャクラスもコピーされます。

  • レイヤーは、フィーチャクラスへの参照にすぎないため、[コピー (Copy)] ツールによってコピーされません。

  • モザイク データセットをコピーすると、モザイク データセットが指定した場所にコピーされます。モザイク データセットが参照する画像はコピーされません。

  • [コピー (Copy)] ツールは、同じジオデータベースへのネットワーク データセットのコピーはサポートしていません。

  • [コピー (Copy)] ツールは MRF 画像形式をサポートしていません。 *.mrf ファイルをコピーするには、[ラスターのコピー (Copy Raster)] ツールを使用します。

  • 入力に関連データがあるとき、関連する出力データの名前とコンフィグレーション キーワードを制御できる場合に [関連データ] パラメーター値が表示されます。

パラメーター

ラベル説明データ タイプ
入力データ

コピーされるデータ。

Data Element
出力データ

出力データの場所および名前。

Data Element
データ タイプ
(オプション)

コピーするディスク上のデータのタイプ。 これは、入力データがジオデータベース内にあり、名前の競合が存在する場合 (同じ名前のフィーチャ データセットとフィーチャクラスがジオデータベースに含まれている場合など) にのみ必要です。 この場合、コピーするデータセットを明確にするために、データ タイプが使用されます。

String
関連データ
(オプション)

入力に関連データがあるとき、このパラメーターを使用して、関連する出力データの名前とコンフィグレーション キーワードを制御できます。

  • [名前から] - 入力データに関連付けられたデータ。これもコピーされます。
  • [データ タイプ] - コピーするディスク上のデータのタイプ。 ジオデータベースに同じ名前のフィーチャ データセットとフィーチャクラスがある場合にのみ、値を指定する必要があります。 この場合、コピーするアイテムのデータ タイプ (FeatureDataset または FeatureClass) を選択する必要があります。
  • [名前] - [出力データ] パラメーター値内のコピーされるデータの名前。
  • [コンフィグレーション キーワード] - ジオデータベースの格納パラメーター (コンフィグレーション)。

[名前から][名前] の列名は、[名前] 値が [出力データ] でまだ使用されていない場合は同じです。 [出力データ] 値に名前がすでに存在する場合、アンダースコアと数字 (たとえば、rivers_1) を追加した一意の [名前] 値が作成されます。

Value Table

arcpy.management.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 - 入力データに関連付けられたデータ。これもコピーされます。
  • data_type - コピーするディスク上のデータのタイプ。 ジオデータベースに同じ名前のフィーチャ データセットとフィーチャクラスがある場合にのみ、値を指定する必要があります。 この場合、コピーするアイテムのデータ タイプ (FeatureDataset または FeatureClass) を使用する必要があります。
  • to_name - out_data パラメーター値内のコピーされるデータの名前。
  • config_keyword - ジオデータベース格納パラメーター (コンフィグレーション)。

from_nameto_name の列名は、to_name 値が out_data でまだ使用されていない場合は同じです。 out_data 値に名前がすでに存在する場合、アンダースコアと数字 (たとえば、rivers_1) を追加した一意の to_name 値が作成されます。

Value Table

コードのサンプル

Copy (コピー) の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで Copy 関数を使用する方法を示しています。

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.Copy_management("majorrds.shp", "C:/output/majorrdsCopy.shp")
Copy (コピー) の例 2 (スタンドアロン スクリプト)

次の 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)
Copy (コピー) の例 3 (スタンドアロン スクリプト)

次の 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: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック