SAS/Warehouse Administrator Metadata Types

WHROWSEL

Metadata type for a row selector

Category:

Process Types

Parent
Overview
Properties
	Property Dependencies
Using WHROWSEL

Parent

WHPRCSPR

Overview

The WHROWSEL type models the metadata for all row selectors. Here is one way to specify row selector metadata through the SAS/Warehouse Administrator interface:

Display a process flow with a mapping in the Process Editor.
In the Process Editor, click the right mouse button on a mapping and select Properties.
Go to the Output Data tab.
Click the Generation Options button.
Click the Row Selection tab.
For the rows that are selected, select Row Selection Conditions and then click the Define button.
In the Expression Builder, select Component of Input Tables and then select an input table and column.
Click OK on each window until you return to the Process Editor.

Properties

The following table lists all of the properties for WHROWSEL 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.
Administrator	L	No	No	No
Cvalue	C	Yes	Yes	No
Desc	C	Yes	Yes	No
Extended Attributes	L	Yes	Yes	Yes
Host	L	No	No	No
Id	C	* Req	* Req	No
Input Objects	L	No	No	No
Input Sources	L	Yes	Yes	No
Is Active	N	No	No	No
Metadata Created	C	No	No	No
Metadata Updated	C	No	No	No
Name	C	No	No	No
Note	L	No	No	Yes
NValue	N	Yes	Yes	No
Output Objects	L	No	No	No
Output Tables	L	* Req	No	No
Outputs Targets	L	No	No	No
Owner	L	No	No	No
Process	L	* Auto supplied	No	No
Responsibility	C	No	No	No
Selection Type	C	Yes (See Property Dependencies)	Yes	No
Source Text	L	Yes (See Property Dependencies)	Yes	No
Step Source Code	L	No	No	Yes

New properties for WHROWSEL are as follows:

INPUT OBJECTS

specifies an SCL list of general identifying information about the columns that are input to this subprocess.

INPUT SOURCES

specifies an SCL list of general identifying information about the nearest intermediate output table or loadable table that is a source to the current table or column. This list must be of type WHCTRNFM or a subtype of WHCOLUMN, and it must have the appropriate relation to the main process. For WHROWSEL, this property can return the same list as INPUT OBJECTS. However, if the user builds the row selector using columns from the output table (in Expression Builder), INPUT SOURCES will return a transformation (WHCTRNFM) and INPUT OBJECTS will return the columns that are used in that transformation.

OUTPUT OBJECTS

specifies a property that is currently unused.

OUTPUT TABLES

specifies an SCL list of general identifying information about the output tables for this subprocess. This list must be of type WHTBLMAP or a subtype of WHTBLMAP. All WHROWSEL subprocesses will have at least one output table that is associated with them.

OUTPUT TARGETS

specifies a property that is currently unused.

PROCESS

specifies an SCL list of general identifying information about the mapping process that called this row selection process. This list must be of type WHPRCMAP or a subtype of WHPRCMAP.

SOURCE TEXT

specifies an SCL list of character items that specify a WHERE clause or other subsetting code. Each item can contain a maximum of 200 characters of source code.

Note: See Property Dependencies. [cautionend]

SELECTION TYPE

specifies a character string that indicates the row selection type. Valid row selection types are ALL ROWS, ROW SELECTION CONDITIONS, or USER DEFINED STATEMENTS.

Note: See Property Dependencies. [cautionend]

Property Dependencies

When you use the indirect add approach,

SELECTION TYPE defaults to ALL ROWS if not otherwise specified by the user.
SOURCE TEXT is optional for indirect adds if the SELECTION TYPE is ALL ROWS; otherwise, SOURCE TEXT is required.

Using WHROWSEL

Add	Update	Delete
No	Yes	Yes

WHROWSEL is a dependent type. To understand how all subtypes of WHPROCES relate to other types, see the process models in Relationships Among Metadata Types.

For details about reading process information, see Reading Process Flow Metadata.

Top of Page