Summary
Compresses all the contents in a geodatabase, all the contents in a feature dataset, or an individual stand-alone feature class or table.
Usage
Once compressed, a feature class or table is read-only and cannot be edited. Compression is ideally suited to mature datasets that do not require further editing. However, if required, a compressed dataset can always be uncompressed to return it to its original, read-write format.
When you compress a geodatabase, all feature classes and tables within it compress.
When you compress a feature dataset, all its feature classes compress.
When you specify a geodatabase as input, this tool compresses all vector feature classes and tables in the geodatabase. It does not compress raster catalogs or raster datasets. If it encounters these in the specified geodatabase, it skips over them. You can individually compress a raster catalog or raster dataset with this tool; however, it makes little sense since the data does not reduce in size. This support is provided strictly as a means to allow ArcPublisher to package to compressed and locked file geodatabase raster catalogs and datasets.
You cannot individually compress or uncompress a feature class in a feature dataset to produce a mixed state where some feature classes are compressed and others are not. Compressed feature datasets allow you to add an uncompressed feature class through operations such as creating a new, empty feature class, copying and pasting, and importing. However, you cannot edit the uncompressed feature class if there are compressed feature classes in the same feature dataset. Once you've finished adding one or more uncompressed feature classes, you can recompress or uncompress the feature dataset so all its feature classes are either compressed or uncompressed.
When you display compressed feature class records, they may not display in the same order as they did before you compressed the data. The records display in the order in which they are compressed and stored.
When using lossless compression, floating-point values will be preserved, but compression will not be as effective. With non-lossless compression, floating-point values will be changed, but not below the limit of adequate precision. For example, state boundaries do not usually need to be measured to nanometer precision. Non-lossless compression is up to 20 percent smaller than lossless.
Syntax
CompressFileGeodatabaseData(in_data, lossless)
Parameter | Explanation | Data Type |
in_data | The geodatabase, feature dataset, feature class, or table to compress. | Feature Dataset; Geometric Network; Raster Layer; Table View; Workspace |
lossless | Indicates whether lossless compression will be used.
This parameter is ignored for pre-10.0 file geodatabases. | Boolean |
Derived Output
Name | Explanation | Data Type |
out_data | The compressed input data. | Workpsace; Feature Dataset; Table View; Raster Layer; Geometic Network |
Code sample
The following example demonstrates how to use the CompressFileGeodatabaseData function in the Python window.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CompressFileGeodatabaseData_management("london.gdb", "Lossless compression")
The following example demonstrates how to use the CompressFileGeodatabaseData function in a stand-alone Python script.
# Name: CompressFileGeodatabaseData.py
# Description: Use the CompressFileGeodatabaseData tool to compress a geodatabase
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
geodatabase = "london.gdb"
lossless = "Lossless compression"
# Process: Compress the data
arcpy.CompressFileGeodatabaseData_management(geodatabase, lossless)
Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes