Define an Oracle Library in SAS Management Console

Define an Oracle Library in SAS Management Console This paper describes how to define an Oracle library in SAS Management Console. By following these steps, you can access your Oracle library from Business Intelligence (BI) clients. There are three main steps for defining an Oracle library in SAS Management Console: 1. Define the Oracle user(s). 2. Define the Oracle server. 3. Define the Oracle library. The goal is to create a LIBNAME statement such as the one shown in this example: LIBNAME oralib ORACLE PATH=alien USER=scott PASSWORD= {sas001}dglnxyz= schema=scott; Note: Before you configure this library in SAS Management Console, make sure that you are able to submit a LIBNAME statement successfully, and that you are able see Oracle tables in the SAS Explorer window. Define the Oracle User(s) To create a group for the Oracle user(s) in SAS Management Console, follow these steps: 1. In SAS Management Console, select User Manager. 2. Right-click Select New and select Group. 3. Click the General tab in the New User Properties window and type the name and description of the new group in the appropriate fields. You can include the User account information. 4. Click the Groups tab and add the appropriate users and groups. 5. Click the Logins tab. Copyright 2006, SAS Institute Inc. All rights reserved. 1

6. In the New Login Properties window, type the Oracle login information for User ID and Password. 7. Click New to name a new Authentication Domain. 8. In the New Authentication Domain window, type the name and description of the domain. 9. Click OK to return to the New Login Properties window. Copyright 2006, SAS Institute Inc. All rights reserved. 2

The new group is now defined in the Authentication Domain field in the New Login Properties window. 10. Click OK. The new login properties are shown on the Logins tab of the Oracle Users Properties window. Copyright 2006, SAS Institute Inc. All rights reserved. 3

Define the Oracle Server Start SAS Management Console without using an unrestricted ID. Make sure that the ID you are using is not SASADM, which is an unrestricted ID. If you use the SASADM user ID when defining the library, the metadata server returns the password as "{sas001}kioqkioqkio=", which is an encryption of all asterisks rather than the correct password. SAS Management Console displays the ID that is being used at the bottom of the screen. 1. From the navigation tree in SAS Management Console, select Server Manager plug-in, then select New Server. The New Server Wizard starts. 2. Expand the Database Servers folder and select Oracle Server. 3. Click Next. Copyright 2006, SAS Institute Inc. All rights reserved. 4

4. In the Name and Description fields, type a name for the new Oracle Server (for example, oracle_server_on_alien) and a description (which is optional). 5. Click Next. oracle_server_on_alien Copyright 2006, SAS Institute Inc. All rights reserved. 5

6. The server properties (Major Version Number, Minor Version Number, Software Version, and Vendor) that are displayed in the new window are default values and should not be changed. The Associated Machine property is the SAS Application Server not the Oracle machine. To change the Associated Machine property, click the down arrow at the right of the field and select the appropriate server from the resulting dropdown list. 7. Click Next. Copyright 2006, SAS Institute Inc. All rights reserved. 6

8. In the Path field in the new window, type the path to the Oracle Server. 9. In the Authentication Domain field, click the arrow at the right of the field and, from the resulting drop-down list, select the Authentication domain that you created in the "Define the Oracle User(s)" section. This will allow the appropriate Oracle User ID and password to be used with this server. 10. Click Next. Click Next again. 11. Click Finish. Copyright 2006, SAS Institute Inc. All rights reserved. 7

Define the Oracle Library To add a new Oracle Library, follow these steps: 1. In the Data Library Manager in SAS Management Console, right-click SAS Libraries, then select New Library. The New Library Wizard starts. 2. Expand the Database Libraries folder and select Oracle Library. 3. Click Next. Copyright 2006, SAS Institute Inc. All rights reserved. 8

4. In the Name and Description fields in the new window, type a name for the new Oracle library (for example, oracle_lib_on_alien and a description (which is optional). 5. Click Next. 6. In the Libref field, type the libref name (for example, ora). Copyright 2006, SAS Institute Inc. All rights reserved. 9

7. Click Next. 8. In the Database Server field, click the down arrow at the right of the field and, from the resulting drop-down list, select the server (for example, oracle_server_on_alien) that you created in the section "Define the Oracle Server". 9. In the Default Login field, click the down arrow at the right of the field and, from the resulting drop-down list, select the Authentication Domain (for example, oraauth) that you defined in the "Define the Oracle Server" section. 10. In order to be able to enter a Database Schema name, click New.. The New Oracle Database Schema Wizard opens. Copyright 2006, SAS Institute Inc. All rights reserved. 10

11. In the Name and Description fields, type a name for the new Oracle schema (for example, Oracle Schema on Alien), and a description (which is optional). Note: The name that you type in this window is NOT the name of your database schema (that name is entered in the next window of the wizard). You can name the Oracle schema anything you want. 12. Click Next. Copyright 2006, SAS Institute Inc. All rights reserved. 11

13. In the Database Schema Name field in the new window, type a name for the database schema. This is the actual database schema name, and it must be the same name as the name you used in the LIBNAME statement. 14. Click Next. 15. Review the Database Schema information and click Finish. 16. Review the Database Library information and click Finish. Verify the Library Definition To check the accuracy of the LIBNAME statement that was generated from the above steps: 1. Right-click new Oracle library in the Data Library Manager list in SAS Management Console. 2. Select Display Library. Copyright 2006, SAS Institute Inc. All rights reserved. 12

3. Copy the LIBNAME statement that is shown in the Display Libname window, paste it in a program editor from your SAS session, and submit the statement. Assign Permissions to This Oracle Library and Tables Entering metadata for a library does not provide access to tables in the library. You must also specify metadata for all tables that you want to access in the library. With SAS 9.1(TS1M3), you can use SAS Management Console to import the tables. To import tables in SAS Management Console, use the following steps: Note: Make sure that you are NOT logged in as SASADM when importing tables from SAS Management Console. 1. Right-click new Oracle library (for example, oracle_lib_on_alien) in the Data Library Manager list in SAS Management Console. 2. Click Import Tables. 3. In the Server field, click the down arrow at the right on the field and, from the resulting drop-down list, select your application server (for example, SASMAIN). 4. Click Next, which displays your library information. 5. Click Next again. A list of Oracle tables is displayed. 6. Right-click the table that you want to import metadata into. 7. Click Next, which displays the table that you are importing metadata into. 8. Click Finish. 9. Right-click the table and select Properties from the drop-down list. 10. Click the Authorization tab. 11. Add the appropriate permissions for the table. If SAS is running on a Windows operating system, you might need to give 'Read and Execute' permissions on the ORACLE_HOME folder for the BI Clients. You can see the permissions values by following these steps: 1. Right-click the ORACLE_HOME directory in Windows Explorer. 2. Select Properties from the drop-down list. 3. Click the Security tab in the Properties window. 4. Select Add. 5. Type Everyone and select Check Names. 6. Click OK. 7. After you add the value Everyone to the Group and User Names, make sure that Everyone has Read and Execute permission. 8. Select Everyone from the Group and User Names, and click Advanced (for special permission or for advanced settings). Copyright 2006, SAS Institute Inc. All rights reserved. 13

9. Verify that the value Everyone is selected and that it has full control. 10. Click the check box Replace permission entries on all child objects with entries shown here that apply to child objects. Recommended Reading SAS Institute Inc. 2006. "SAS/ACCESS for Oracle", SAS OnlineDoc 9.1.3. Available at support.sas.com/onlinedoc/913/docmainpage.jsp. SAS Institute Inc. 2006. Administering SAS Enterprise Guide 4.1. Available at support.sas.com/documentation/onlinedoc/guide/admin4.pdf. SAS Institute Inc. 2006. SAS 9.1.3 Intelligence Platform: System Administration Guide. Available at support.sas.com/documentation/configuration/bisag.pdf.. Note: This document applies to SAS versions 9.1.3 and higher. SAS and all other SAS Institute Inc. product or service names are registered trademarks or trademarks of SAS Institute Inc. in the USA and other countries. indicates USA registration. Other brand and product names are trademarks of their respective companies. Copyright 2006, SAS Institute Inc. All rights reserved. 14