WHDATTBL Metadata type for data tables Category: Object Types—Explorer Parent “WHTABLE” on page 254 Overview WHDATTBL models the metadata for data tables in SAS/Warehouse Administrator..
Trang 192 WHDATTBL Chapter 3
Using WHCTRNFM
WHCTRNFM is a dependent type To understand how it relates to other types, see the column mapping models in “Relationships Among Metadata Types” on page 53
WHDATTBL
Metadata type for data tables Category: Object Types—Explorer
Parent
“WHTABLE” on page 254
Overview
WHDATTBL models the metadata for data tables in SAS/Warehouse Administrator A
data table is a multipurpose table You can use it as a detail data store, a summary
data store, a look-up table included as part of a join, or a table that holds information that does not fit anywhere else
A data table can be a SAS table or view or a DBMS table or view To add a data table with the SAS/Warehouse Administrator Explorer:
1 Select a data group with the right mouse button
2 Select Add Item data table
3 Select the data table with the right mouse button
4 Select Properties.
5 Enter the data table information
Properties
The following table lists all of the properties for WHDATTBL and indicates how you can use each property with metadata API methods
In the table, you can pass properties with a Yes in the Add column to the
_ADD_METADATA_ method Use this method to add a new object
You can pass properties with a Yes in the Update column to the
_UPDATE_METADATA_ method Use this method to update properties of an existing object
* 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
Trang 2SAS/Warehouse Administrator Metadata Types WHDATTBL 93
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
Expand Parm Access Same As
Physical
Property Dependencies)
Yes (see Property Dependencies)
No
Extended
Attributes
Property Dependencies)
Yes (see Property Dependencies)
No
Resolved View
Code
Trang 394 WHDATTBL Chapter 3
New properties for WHDATTBL are as follows:
RESOLVED VIEW CODE specifies an SCL list of general identifying information about the source code that
is used to view (open) this data table This property will return a copy of the
source code with the &loc reference replaced with the appropriate location information See the Note below.
VIEW CODE specifies an SCL list of general identifying information about the source code that
is used to view (open) this data table This property will return a copy of the
source code with the &loc reference unresolved See the Note below.
Note: The VIEW CODE and RESOLVED VIEW CODE properties are very closely related 4
When you write the source code to view (open) a data table, you can insert &loc into
the text as a placeholder for the data table’s location information—information such as
libref.catalog.entry.type, for example The VIEW CODE property will return a copy of
the source code with the &loc reference unresolved The RESOLVED VIEW CODE property will return a copy of the source code with the &loc reference replaced with the
appropriate location information
The RESOLVED VIEW CODE property is provided as a convenience and removes
the burden from the application of parsing the returned code and replacing the &loc reference If the source code does not contain the &loc placeholder, the returned source
code is the same for both properties
Property Dependencies You must define a CREATING JOB property in order to add any INPUT SOURCES to a table If a table does not have a CREATING JOB property, then you must specify one when adding an input source to the table
Using WHDATTBL
WHDATTBL is an independent type, like its parent, WHTABLE To understand how all subtypes of WHTABLE relate to other types, see the table model in “Relationships Among Metadata Types” on page 53
When you update or add the VIEW CODE property, see “Using WHINFO” on page 134
You can also use the WHDATTBL type to read Data Mart objects that were created prior to SAS/Warehouse Administrator, Release 1.3
Trang 4SAS/Warehouse Administrator Metadata Types WHDBMS 95
WHDBMS
Metadata type for DBMS connection definitions Category: Global Metadata Types
Parent
“WHROOT” on page 226
Overview
WHDBMS models the metadata for a database management system connection definition in SAS/Warehouse Administrator All warehouses in an environment can share DBMS definitions In SAS/Warehouse Administrator, to add a DBMS connection definition to the current environment in the Explorer:
1 Select File Setup from the pull-down menu
2 Select DBMS Connections.
3 Click Add
4 Enter the connection information
Properties
The following table lists all of the properties for WHDBMS and indicates how you can use each property with metadata API methods
In the table, you can pass properties with a Yes in the Add column to the
_ADD_METADATA_ method Use this method to add a new object
You can pass properties with a Yes in the Update column to the
_UPDATE_METADATA_ method Use this method to update properties of an existing object
* 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
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
Expand Parm Connection
Options
Extended Attributes
Trang 596 WHDBMS Chapter 3
New properties for WHDBMS are as follows:
CONNECTION OPTIONS represents an SCL list of options that are needed to access the DBMS in this connection The SQL sublist contains the options that are needed to access the DBMS through the SQL Pass-Through facility These are options normally specified in the CONNECT TO statement The DBLOAD sublist contains statements that are needed to access the DBMS when you use PROC DBLOAD LIBRARIES
specifies an SCL list of general identifying information about the libraries that are associated with this DBMS connection
NICKNAME specifies the nickname of the DBMS in this connection Valid nicknames are limited to DB2/AIX, DB2/MVS, Informix, Oracle, SQL Server, and SYBASE
If a passed nickname is not a known nickname, it is accepted if it is a valid SAS name
PASSWORD represents the maximum 200-character string for a password that is registered for this database connection This property contains the registered password only if
the API application is a secure application The only secure applications currently supported are those registered as add-in generators See the SAS/Warehouse
Administrator User’s Guide for documentation on add-in generators If the API
application is not secure, this property returns a blank value if no password has been registered, and it returns XXXXXXXX if the password has been registered TABLES
specifies an SCL list of general identifying information about the tables that are associated with this DBMS connection
USERID represents the maximum 200-character string for the user ID that is registered for this database connection This property contains the registered user ID only if the
API application is a secure application The only secure applications currently
supported are those that are registered as add-in generators See the
SAS/Warehouse Administrator User’s Guide for documentation on add-in