SAS/Warehouse Administrator Metadata Types

WHSASSTR

Metadata type for SAS physical data stores

Category:

Physical Storage Types

Parent
Overview
Properties
Using WHSASSTR
	TABLE OPTIONS Property and SAS Data Set Passwords

Parent

WHPHYSTR

Overview

WHSASSTR models the metadata for SAS physical data stores in SAS/Warehouse Administrator. These stores are specified for tables that are stored in SAS format, using the Physical Storage tab in the table property window.

Properties

The following table lists all of the properties for WHSASSTR and indicates how you can use each property with metadata API methods.

In the table, you can specify properties with a Yes in the Indirect Add column when you indirectly add one object through another, as described in the documentation for the _UPDATE_METADATA_ method. Use this approach to add a new dependent object. For details, see Using _UPDATE_METADATA_.

You can pass properties with a Yes in the Update column to the _UPDATE_METADATA_ method, as described in the documentation for this method. Use this method to update properties of an existing object. For details, see Using _UPDATE_METADATA_.

* Req indicates that the property is required; you must provide a value for this property when you use a given method. * Default indicates that the system will provide a default value for that property if you do not provide one. * Auto supplied means that the property is automatically supplied; any value that you specify for such a property is ignored.

Properties with a Yes in the Read Method Expand Parm column are valid with the expand parameter of the _GET_METADATA_ method. This method enables you to get detailed metadata about a property and its associated objects through a single method call.

Properties	Type	Indirect Add	Update Method	Read Method Expand Parm.
Cvalue	C	Yes	Yes	No
Desc	C	Yes	Yes	No
Extended Attributes	L	Yes	Yes	Yes
Host	L	Yes	Yes	No
Id	C	* Req	* Req	No
Indexes	L	Yes	Yes	Yes
Library	L	Yes	Yes	No
Load Technique	C	Yes	Yes	No
Metadata Created	C	* Auto supplied	No	No
Metadata Updated	C	* Auto supplied	No	No
Name	C	No	No	No
Note	L	No	No	Yes
NValue	N	Yes	Yes	No
Table	L	* Auto supplied	No	No
Table Name	C	Yes	Yes	No
Table Options	L	* Default	* Default	No

New properties for WHSASSTR are as follows:

HOST

specifies an SCL list of general identifying information about the host on which this data is accessed.

LIBRARY

specifies an SCL list of general identifying information about the SAS Library that contains this data store.

TABLE OPTIONS

specifies an SCL list of options that are used in creating or loading this table. The CREATE sublist contains the SQL options that are used to create the table. The LOAD sublist contains the DBLOAD statements that are used to load the table.

See the Usage notes for details about the TABLE OPTIONS property and data set passwords.

Using WHSASSTR

Add	Update	Delete
No	Yes	No

WHSASSTR is a dependent type. To understand how it relates to other types, see the physical storage models in Relationships Among Metadata Types.

TABLE OPTIONS Property and SAS Data Set Passwords

The actual data set passwords will only be returned using the _GET_METADATA_ method if the application is running as a secure application. The only method that is currently supported to run as a secure application is to run as an add-in generator. See SAS/Warehouse Administrator User's Guide for documentation on running as an add-in generator. You can determine the presence of passwords however, regardless of whether the application is secure.

If the application is not secure and a password exists, the appropriate data set password option will be returned with a value of XXXXXXXX (8 uppercase Xs). If the application is secure, the actual password will be returned. The three supported password options are READ=, WRITE=, and ALTER=. You can search for these strings in the returned string (using the INDEX function) to determine if a password exists this type of access. It is the application's responsibility of retrieving these passwords--by prompting the user, for example.

An example of a data set with a WRITE password and the COMPRESS option follows:

TABLE OPTIONS=( CREATE=( 'WRITE=XXXXXX COMPRESS'                                                   
              )        )

When you use the _UPDATE_METADATA_ method, you can add passwords to an existing data set that has no password, but you cannot update an existing password. To update an existing data set password, see your administrator. Note that changes to the metadata alone can cause your metadata and data to become out of sync. You should use this functionality with extreme caution.

Top of Page