| The EXPORT Procedure |
| Featured in: | All examples |
|
PROC EXPORT DATA=<libref.>SAS-data-set
<(SAS-data-set-options)>
OUTFILE="filename" | OUTTABLE="tablename" <DBMS=identifier> <REPLACE>; |
| Required Arguments |
identifies the input SAS data set with either a one- or two-level SAS name (library and member name). If you specify a one-level name, by default, PROC EXPORT uses either the USER library (if assigned) or the WORK library (if USER not assigned).
| Default: | If you do not specify a SAS data set, PROC EXPORT uses the most recently created SAS data set, which SAS keeps track of with the system variable _LAST_. However, in order to be certain that PROC EXPORT uses the correct data set, you should identify the SAS data set. |
| Restriction: | PROC EXPORT can export data only if the format of the data is supported by the data source or the amount of data is within the limitations of the data source. For example, some data sources have a maximum number of rows or columns, and some data sources cannot support SAS user-defined formats and informats. If the data that you want to export exceeds the limits of the data source, PROC EXPORT may not be able to export it correctly. When incompatible formats are encountered, the procedure formats the data to the best of its ability. |
| Restriction: | PROC EXPORT does not support writing labels as column names. However, SAS does support column names up to 32 characters. |
| Featured in: | All examples |
specifies SAS data set options. For example, if the data set that you are exporting has an assigned password, you can use the ALTER=, PW=, READ=, or WRITE= data set option, or to export only data that meets a specified condition, you can use the WHERE= data set option. For information about SAS data set options, see "Data Set Options" in SAS Language Reference: Dictionary.
| Restriction: | You cannot specify data set options when exporting delimited, comma-separated, or tab-delimited external files. |
| Featured in: | Exporting a Subset of Observations to an Excel Spreadsheet |
specifies the complete path and filename or a fileref for the output PC file, spreadsheet, or delimited external file. If you specify a fileref or if the complete path and filename does not include special characters (such as the backslash in a path), lowercase characters, or spaces, you can omit the quotation marks. A fileref is a SAS name that is associated with the physical location of the output file. To assign a fileref, use the FILENAME statement. For more information about PC file formats, see SAS/ACCESS for PC Files: Reference.
| Featured in: | Exporting a Delimited External File, Exporting a Subset of Observations to an Excel Spreadsheet, and Exporting to a Specific Spreadsheet in an Excel Workbook |
| Restriction: | PROC EXPORT does not support device types or access methods for the FILENAME statement except for DISK. For example, PROC EXPORT does not support the TEMP device type, which creates a temporary external file. |
| Restriction: | For client/server applications: When running SAS/ACCESS software on UNIX to access data that is stored on a PC server, you must specify the full path and filename of the file that you want to import. The use of a fileref is not supported. |
specifies the table name of the output DBMS table. If the name does not include special characters (such as question marks), lowercase characters, or spaces, you can omit the quotation marks. Note that the DBMS table name may be case sensitive.
| Requirement: | When you export a DBMS table, you must specify the DBMS= option. |
| Featured in: | Exporting a Microsoft Access Table |
| Options |
specifies the type of data to export. To export a DBMS table, you must specify DBMS= by using a valid database identifier. For example, DBMS=ACCESS specifies to export a table into a Microsoft Access 2000 or 2002 database. To export PC files, spreadsheets, and delimited external files, you do not have to specify DBMS= if the filename that is specified in OUTFILE= contains a valid extension so that PROC EXPORT can recognize the type of data. For example, PROC EXPORT recognizes the filename ACCOUNTS.WK1 as a Lotus 1-2-3 Release 2 spreadsheet and the filename MYDATA.CSV as an external file that contains comma-separated data values; therefore, a DBMS= specification is not necessary.
| Tip: | When you specify DBMS=XLS for an Excel file, you can read and write Excel spreadsheets under UNIX directly, without having to access the PC Files server. |
The following values are valid for the DBMS= option:
* Not available for Microsoft Windows 64-Bit Edition.** Value listed here is the default value. The real version of file loaded depends on the version of the existing file or the value specified for VERSION= statement.
| Restriction: |
The availability of an output data
source depends on
|
| Featured in: | Exporting a Delimited External File and Exporting a Microsoft Access Table |
When you specify a value for DBMS=, consider the following for specific data sources:
To export to an existing Microsoft Access database, PROC EXPORT can write to Access 97, Access 2000, or Access 2002 regardless of your specification. For example, if you specify DBMS=ACCESS2000 and the database is in Access 97 format, PROC EXPORT exports the table, and the database remains in Access 97 format. However, if you specify OUTFILE= for an Access database that does not exist, a new database is created using the format specified in DBMS=. For example to create a new Access database, specifying DBMS=ACCESS (which defaults to Access 2000 or 2002 format) creates an MDB file that can be read by Access 2000 or Access 2002, not by Access 97.
The following table lists the DBMS= specifications and indicates which version of Microsoft Access can open the resulting database:
| Specification | Access 2002 | Access 2000 | Access 97 |
|---|---|---|---|
| ACCESS | yes | yes | no |
| ACCESS2002 | yes | yes | no |
| ACCESS2000 | yes | yes | no |
| ACCESS97 | yes | yes | yes |
To export a Microsoft Excel spreadsheet, PROC EXPORT creates an XLS file for the version specified. The following table lists the DBMS= specifications and indicates which version of Microsoft Excel can open the resulting spreadsheet:
Note: Later versions of Excel can open and update files
in earlier formats. ![[cautionend]](../common.hlp/images/cautend.gif)
When exporting a SAS data set to a dBASE file (DBF), if the data set contains missing values (for either character or numeric values), the missing values are translated to blanks.
When exporting a SAS data set to a dBASE file (DBF), values for a character variable that are longer than 255 characters are truncated in the resulting dBASE file because of dBASE limitations.
overwrites an existing file. Note that for a Microsoft Access database or an Excel workbook, REPLACE overwrites the target table or spreadsheet. If you do not specify REPLACE, PROC EXPORT does not overwrite an existing file.
| Featured in: | Exporting a Subset of Observations to an Excel Spreadsheet and Exporting a Microsoft Access Table |
Copyright © 2006 by SAS Institute Inc., Cary, NC, USA. All rights reserved.