Help

Alter Mosaic Dataset Schema

Summary

Defines which editing operations nonowners have when editing a mosaic dataset in an enterprise geodatabase.

This tool prevents schema-locking issues that can arise when a mosaic dataset is stored in an enterprise geodatabase. The owner of the geodatabase runs this tool to create any side tables and fields that may be needed by the user. The owner must also grant the proper permissions to allow users to insert, update, or delete records.

Usage

  • This tool is only necessary when you are creating a mosaic dataset within an enterprise geodatabase and a nonowner will be editing the mosaic dataset.

  • Use this tool to set up a mosaic dataset that will be published as an image service allowing users to upload or edit the items. A user can only upload their data if the raster type is allowed by the mosaic dataset.

  • Choose the operations allowed for this mosaic dataset. If a nonowner tries to perform an operation that is not allowed, the operation will fail.

  • The raster types specified by this tool control what rasters a nonowner can add using the Add Rasters To Mosaic Dataset tool. If the nonowner tries to add a Raster type that has not been specified by this tool, the Add Rasters To Mosaic Dataset tool will fail.

  • If you run this tool without choosing any raster types, only the additional mosaic dataset tables will be created. These tables include overview, seamline, color correction, stereo, cell size levels, status, error, and permissions.

Syntax

AlterMosaicDatasetSchema_management (in_mosaic_dataset, {side_tables}, {raster_type_names}, {editor_tracking})
ParameterExplanationData Type
in_mosaic_dataset

The mosaic dataset on which to change permitted operations.

Mosaic Layer
side_tables
[operation,...]
(Optional)

The operations permissible for this mosaic dataset.

  • ANALYSIS —Choose this option if a nonowner is allowed to run the Analyze Mosaic Dataset tool on the mosaic dataset.
  • BOUNDARY —Choose this option if a nonowner is allowed to create or edit the boundary of the mosaic dataset. This is also required if a nonowner will add rasters outside of the existing boundary.
  • CACHE —Choose this option if a nonowner is allowed to create cache for the mosaic dataset.
  • COLOR_CORRECTION —Choose this option if a nonowner is allowed to color correct the mosaic dataset.
  • DEFINITION —Choose this option if a nonowner is allowed to add multidimensional data or a processing template to the mosaic dataset.
  • LEVELS —Choose this option if a nonowner is allowed to calculate cell size ranges or create seamlines for the mosaic dataset.
  • LOG —Choose this option if a nonowner is allowed to create a log table for the mosaic dataset.
  • OVERVIEW —Choose this option if a nonowner is allowed to create overviews for the mosaic dataset.
  • SEAMLINE —Choose this option if a nonowner is allowed to create seamlines for the mosaic dataset.
  • STEREO —Choose this option if a nonowner is allowed to define stereo pairs for the mosaic dataset.
  • VIEW —Choose this option if a nonowner is allowed to edit the image service. The editor_tracking parameter will be automatically enabled when VIEW is used, since the View table has to have editor tracking turned on.
String
raster_type_names
[raster_type,...]
(Optional)

The raster types allowable for this mosaic dataset.

  • CADRG/ECRG —CADRG/ECRG raster type
  • CIB —CIB raster type
  • DTED —DTED raster type
  • DMCii —DMCii raster type
  • FORMOSAT-2 —FORMOSAT-2 raster type
  • Frame Camera —Frame Camera raster type
  • GeoEye-1 —GeoEye-1 raster type
  • GRIB —GRIB raster type
  • HDF —HDF raster type
  • HRE —HRE raster type
  • IKONOS —IKONOS raster type
  • KOMPSAT-2 —KOMPSAT-2 raster type
  • LAS — LAS raster type
  • Landsat 1-5 MSS —Landsat 1-5 MSS raster type
  • Landsat 4-5 TM —Landsat 4-5 TM raster type
  • Landsat 7 ETM+ —Landsat 7 ETM+ raster type
  • Landsat 8 —Landsat 8 raster type
  • NITF —NITF raster type
  • NetCDF —NetCDF raster type
  • Pleiades-1 —Pleiades-1 raster type
  • QuickBird —Quickbird raster type
  • RADARSAT-2 —RADARSAT-2 raster type
  • RapidEye — RapidEye raster type
  • Raster Process Definition —Raster Process Definition raster type
  • SPOT 5 —SPOT 5 raster type
  • SPOT 6 —SPOT 6 raster type
  • WorldView-1 —WorldView-1 raster type
  • WorldView-2 — WorldView-2 raster type
  • WorldView-3 —WorldView-3 raster type

If you wish to use a custom raster type, enter the path of the custom raster type file.

String
editor_tracking
(Optional)

Editor tracking can help you maintain accountability and enforce quality-control standards. For more information about Editor Tracking, see About tracking an editor's changes to data.

  • NO_EDITOR_TRACKING —Do not turn on editor tracking. This is the default.
  • EDITOR_TRACKING —Enables editor tracking for your mosaic dataset.

If the VIEW keyword is used in the side_tables parameter, then editor tracking will automatically be enabled.

Boolean

Code sample

AlterMosaicDatasetSchema example 1 (Python window)

This is a Python sample for the AlterMosaicDatasetSchema tool.

import arcpy
arcpy.AlterMosaicDatasetSchema_management(
    "C:/folder/mySDEcon.sde/md_01", 
    "ANALYSIS;BOUNDARY;LEVELS;OVERVIEW;VIEW",
    "QuickBird;IKONOS", "EDITOR_TRACKING")
AlterMosaicDatasetSchema example 2 (stand-alone script)

This is a Python script sample for the AlterMosaicDatasetSchema tool.

#Alter Mosaic Dataset Schema mainly works on SDE mosaic datasets. The 
#selected side tables of mosaic dataset will be created. If there are
#raster type settings, metadata fields will be create for that raster type.

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
mosaicds = "sdeserver.sde/mosaicds"
ops = "ANALYSIS;BOUNDARY;LEVELS;LOG;OVERVIEW"
rastypes = "QuickBird;IKONOS;Match-AT"

arcpy.AlterMosaicDatasetSchema_management(mosaicds, ops, rastypes)

Environments

This tool does not use any geoprocessing environments

Licensing information

  • ArcGIS for Desktop Basic: No
  • ArcGIS for Desktop Standard: Yes
  • ArcGIS for Desktop Advanced: Yes

Related topics