Embarcadero DBArtisan

Transcription

1 Product Documentation Embarcadero DBArtisan Quick Start Guide Version XE 2/9.0 1st Edition June, 2011

2 2011 Embarcadero Technologies, Inc. Embarcadero, the Embarcadero Technologies logos, and all other Embarcadero Technologies product or service names are trademarks or registered trademarks of Embarcadero Technologies, Inc. All other trademarks are property of their respective owners. This software/documentation contains proprietary information of Embarcadero Technologies, Inc.; it is provided under a license agreement containing restrictions on use and disclosure and is also protected by copyright law. Reverse engineering of the software is prohibited. Embarcadero Technologies, Inc. is a leading provider of award-winning tools for application developers and database professionals so they can design systems right, build them faster and run them better, regardless of their platform or programming language. Ninety of the Fortune 100 and an active community of more than three million users worldwide rely on Embarcadero products to increase productivity, reduce costs, simplify change management and compliance and accelerate innovation. The company s flagship tools include: Embarcadero Change Manager, CodeGear RAD Studio, DBArtisan, Delphi, ER/Studio, JBuilder and Rapid SQL. Founded in 1993, Embarcadero is headquartered in San Francisco, with offices located around the world. Embarcadero is online at CORPORATE HEADQUARTERS EMEA HEADQUARTERS ASIA-PACIFIC HEADQUARTERS 100 CALIFORNIA STREET 12TH FLOOR SAN FRANCISCO, CALIFORNIA USA YORK HOUSE 18 YORK ROAD MAIDENHEAD, BERKSHIRE SL6 1SF, UNITED KINGDOM L LA TROBE STREET MELBOURNE VIC 3000 AUSTRALIA

3 CONTENTS Contents Contents 3 Introduction About DBArtisan About This Book Installing DBArtisan Technical Requirements Database Support Installing DBArtisan Licensing Additional Product Resources Tutorial exercises Session 1: Getting Started with DBArtisan Session 2: Object and Schema Management Session 3: Database Security Management Session 4: Space Management Session 5: SQL Management Session 6: Job Management Session 7: Data Management Working with Table Data Extract Data as XML Session 8: Performance Management Session 9: Capacity Management Session 10: General Utilities and Tools New Features Updated DBMS Version Support SQL Server Feature Support Oracle Feature Support Sybase Feature Support DB2 z/os Feature Support Datasource/Server Updates Unicode updates SQL Editor Performance Analyst Updates User interface changes and related features DBARTISAN XE 2/9.0 QUICK START GUIDE 3

4 CONTENTS 4 DBARTISAN XE 2/9.0 QUICK START GUIDE

5 INTRODUCTION DBArtisan is an industry-leading database administration solution for managing Oracle, Microsoft SQL Server, Sybase Adaptive Server, IBM DB2 for Windows, Unix, and Linux, IBM DB2 for z/os databases, and MySQL. Its cross-platform capability allows users to efficiently manage heterogeneous database platforms easily using a single front-end tool. Using DBArtisan, users boost their productivity by using a single tool for all their databases, regardless of vendor. ABOUT DBARTISAN DBArtisan provides tools that can be used by a number of functions within an organization using DBMS from multiple vendors, in testing, development, or production environments. MAJOR FUNCTIONAL AREAS Datasource management tools - Before use with DBArtisan, datasources must be registered. Datasources can be registered manually or semi-automatically. Storage can be registry-based or file-based, and a network storage option facilitates shared use of datasource catalogs. Object management tools - DBArtisan supports a wide range of database objects and related elements for each DBMS. You can create new objects, edit existing objects, and use a range of object operations that supporting common, general or DBMS-specific actions. Scripting environments - DBArtisan offers fully-featured environments dedicated to SQL, DDL, Java and Active Script development. Execution options are available as appropriate, and enviroment-specific related features, such as rollback/commit and query plan options, are provided. Related coding aids include on-the-fly semantic and syntactic validation, text substitution shortcuts, and visual query building tools. Related execution tools include script and file execution facilities. Schema and data utilities - Schema extraction, migration, and publication wizards let you quickly extract and move schema and data across environments and even across DBMS types. DBMS-specific mport/export, load/unload, and backup/restore utilities are also available. A Data Editor lets you edit your tables in real-time, supports all editable datatypes, and provides unicode options. Table data can also be imported from formats such as spreadsheets. Other Time-savers and Productivity Tools - Working within the DBArtisan environment, you have access to database and file search facilities, use visual difference to compare files or database objects, and access the Microsoft Windows task scheduler. License-specific Add-ons - Depending on the licenses you purchased, you have access to the following tools: The Analyst Series includes advanced space, capacity, performance and backup management capabilities. They let you predict and prevent storage-related problems, trend data and object growth over time, and pinpoint performance bottlenecks. DBARTISAN XE 2/9.0 QUICK START GUIDE 5

6 INTRODUCTION Debuggers, available for IBM DB2 for Linux, Unix, and Windows, Oracle, Sybase, and SL Server, let you test functions and procedures. A Profiler is available for Oracle datasources. BENEFITS TO SPECIFIC USERS DBArtisan provides benefits to the following users: Database Administrators Developers Project Managers DBArtisan lets database administrators accomplish more with the limited time they have. It eliminates the tedious tasks associated with researching schema dependencies when making object changes. Also included are a host of utilities, which condense DBA tasks taking hours or days down to minutes. DBArtisan provides an easy-to-use graphical user interface (GUI), which allows Database Developers to be immediately productive in a cross-platform environment without having platform specific knowledge. The GUI in general, and wizards and editors specifically, provide time-savings over traditional hand-coding or other manual methods. In addition to a fully-featured scripting environment, DBArtisan offers several crossplatform code-generation options, which help Developers build SQL code that is syntactically and functionally correct the first time. Complementing coding facilities, the object creation wizards and graphical object editors greatly reduce the time and effort to build an application database from the ground up. DBArtisan facilitates moving applications and complete database systems between environments. Project management facilities and Version Control System integration provide fundamental project management. ABOUT THIS BOOK This book has three major components: Installing DBArtisan lists technical requirements, provides details on DBMS version support, summarizes the installation process, and includes licensing details. Tutorial exercises provides learning curve material on DBArtisan. It walks you through the major areas of functionality, getting you ready for independent work. New Features describes all feature updates for the current major release. 6 DBARTISAN XE 2/9.0 QUICK START GUIDE

7 INSTALLING DBARTISAN Before you can register any Embarcadero Technologies application, you must meet the minimum technical requirements. If you meet all the minimum technical requirements, you can install DBArtisan. After installation, you must license the application. The following topics walk you through this process: Technical Requirements Database Support Installing DBArtisan Licensing Lastly, for more information, see Additional Product Resources. TECHNICAL REQUIREMENTS DBArtisan is a 32-bit application that runs in a Microsoft Windows environment. Before using DBArtisan, please verify that your environment meets the following requirements: Microsoft Internet Explorer 5.5 or later Hardware requirements Operating system requirements NOTE: Users need full registry privileges during the installation and access to the keys under HKEY_CURRENT_USER in the registry after installation. HARDWARE REQUIREMENTS Embarcadero Technologies recommends the following minimum hardware requirements: 1024 MB of memory 512 MB of disk space OPERATING SYSTEM REQUIREMENTS DBArtisan supports the following operating systems: Windows 7 (32-bit and 64-bit) Windows XP (32-bit and 64-bit) Windows Vista (32-bit and 64-bit) For more detailed information, see the following topics: DBARTISAN XE 2/9.0 QUICK START GUIDE 7

8 INSTALLING DBARTISAN XP Support Vista and Windows 7 Support 32-bit Versus 64-bit Operating System Support and Restrictions XP SUPPORT Windows XP has two user security groups: Users Power Users Microsoft intentionally does not grant members of the Users Group the authority to install applications or make global changes to the system. Restricted Users are members of the Users Group. Standard users belong to the Power Users Group. Microsoft grants members of the Power Users Group the authority to install programs. You must be a member of the Administrators Group in order to install and use Embarcadero Technologies applications. Because Restricted Users are members of the Users Group, they cannot install and run Embarcadero Technologies applications. CAUTION: You must be a member of the Administrators Group in order to install and use Embarcadero Technologies applications. To open the Group Membership tab where you can determine your group and review the Microsoft security guidelines: 1 On the Control Panel, open User Accounts. 2 On the Users tab, select a user and then click the Properties button. 3 Click the Group Membership tab. VISTA AND WINDOWS 7 SUPPORT Windows Vista UAC and Windows 7 provide two user types: Standard user Administrator DBArtisan can be installed or uninstalled by an administrator or by a standard user using an administrator token. Standard users can run DBArtisan. CAUTION: For the purposes of running DBArtisan, default standard user token privileges should not be modified. Modifying standard user token privileges can result in licensing issues which will prevent DBArtisan from operating properly. 8 DBARTISAN XE 2/9.0 QUICK START GUIDE

9 INSTALLING DBARTISAN 32-BIT VERSUS 64-BIT OPERATING SYSTEM SUPPORT AND RESTRICTIONS DBArtisan is a 32-bit application that runs emulated on 64-bit versions of Windows. The only requirement is that DBArtisan supports only 32-bit versions of the client software that must be installed for connectivity to each DBMS that DBArtisan will work against. DATABASE SUPPORT The table below describes the database platforms DBArtisan supports and the server and client requirements: Platform Server Client IBM DB2 for z/os IBM DB2 for z/os 8 and 9. When going through a DB2 Connect gateway, DB2 Client for Windows 6.0 or later. When going directly to the mainframe from the client, DB2 Connect Personal Edition v6 or higher on the client machine. IBM DB2 for Linux, Unix, and Windows IBM DB2 Universal Database IBM DB2 Client for Windows 7.2 or later. NOTE: When using a v8 client, DBArtisan only supports connecting to a v8 Database on Windows, Linux and Unix. Microsoft SQL Server Microsoft SQL Server 2000, 2005, and 2008 NOTE: For SQL Server 2005 and 2008, only object types like users, logins, roles, config parameters, etc., are supported. We do NOT support Microsoft.NET extensions at this time. Microsoft SQL Server Client Library MySQL MySQL 4.x. (DBArtisan is tolerant of 5.x but does not support Stored Procedures, Triggers, Views.) MySQL ODBC driver and above Oracle Oracle 8i, 9i, 10g, and 11g Oracle SQL*Net Client Sybase ASE Sybase ASE Sybase Open Client NOTE: Since DBArtisan is a 32-bit application that runs emulated on 64-bit versions of Windows, only 32-bit versions of the DBMS client software are supported. IBM DB2 FOR Z/OS STORED PROCEDURE REQUIREMENTS When working against an IBM DB2 for z/os data source, DBArtisan relies on the following stored procedures, provided as an optional installation step in setting up the DB2 subsystem: DSNWZP DSNUTILS ADMIN_COMMAND_DSN ADMIN_COMMAND_DB2 DBARTISAN XE 2/9.0 QUICK START GUIDE 9

10 INSTALLING DBARTISAN Prior to using DBArtisan against an IBM DB2 for z/os data source, ensure that these components are installed on the server. See v2r2/topic/com.ibm.db2.doc.inst/stpadd.htm#stpadd for more information. INSTALLING DBARTISAN To install DBArtisan successfully, you must complete each panel of the Installation Wizard. After the installation is complete, we recommend that you reboot your machine before using DBArtisan. CAUTION: To install DBArtisan from the command line, you should be sure to manually uninstall all prior versions of DBArtisan. INSTALLATION WIZARD The DBArtisan Installation Wizard installs all corresponding files on your machine. The panels presented by the wizard vary depending on whether you are upgrading or performing an initial installation. To proceed to the next panel of the wizard, click Next. To cancel the installation process at any time, click Cancel. NOTE: Before installing DBArtisan from Embarcadero ToolCloud, see docs.embarcadero.com/products/xe/ for additional requirements or revised instructions. CAUTION: If you have not registered a license when you start a DBArtisan installation, you will be prompted to register a license. For more information, see Licensing. Use the following table as a guide to understanding the panels you may encounter when installing DBArtisan: Panel Welcome... License Agreement Destination Folder Start Menu Associate Files Ready to install the program Installing... Setup Complete Description The start of the install process. This panel of the Installation Wizard displays the license agreement. To continue the installation, click I accept the terms in the license agreement. You cannot proceed to the next step in the installation if the I DO NOT accept the terms in the license agreement option is selected. Identify the folder where you want the program files to reside. The default directory is C:\Program Files\Embarcadero\DBA<version identifier>\. Lets you provide a Start menu group and optionally have an application icon created on the desktop. Specify whether you want files with extensions of.sql or.eqb to be associated with the DBArtisan application. Review your settings and click Install to continue the installation process. Displays installation progress. Finishes the installation process. 10 DBARTISAN XE 2/9.0 QUICK START GUIDE

11 INSTALLING DBARTISAN LICENSING Each Embarcadero client application requires one or more licenses in order to run. An Embarcadero product, such as DBArtisan or ER/Studio, has a baseline license which provides basic feature support for that product. In addition, incremental licenses may be required to support specific DBMS platforms, product add-ons, or other functions. For more information, see the following topics: Licensing Overview Licensing your Application Selecting a License Cateory During Startup Online/Offline Mode and Concurrent License Checkout LICENSING OVERVIEW The following topics provide a high-level discussion of key licensing topics and directs you to sources of more detailed information. Viewing your License Type and Modules Understanding Trial, Workstation, and Networked Licenses DBArtisan License Modules, DBMS Support, and Feature Availability DBArtisan XE License Modules, DBMS Support, and Feature Availability Directing Queries Regarding Licenses VIEWING YOUR LICENSE TYPE AND MODULES The About... dialog, available from the Help menu, displays your license type and each individual license module currently registered. UNDERSTANDING TRIAL, WORKSTATION, AND NETWORKED LICENSES Three kinds of licenses are available: Trial, Workstation, and Networked. Trial licenses Workstation licensing A license for a 14-day, full-featured trial version of the product. The trial license must be registered before you can use the product. A license or set of licenses is tied to a particular workstation. The product can only be used on that workstation. DBARTISAN XE 2/9.0 QUICK START GUIDE 11

12 INSTALLING DBARTISAN Networked licensing Networked licenses are administered and distributed by a central License Server (Embarcadero License Center or Acresso FLEXnet Publisher). There are two types of networked licenses: Concurrent and Networked Named User. With Concurrent licensing, users on different machines take turns using licenses from a shared pool. With Networked Named User licensing, licenses are pre-assigned to specific users setup on the license server's user list. Those users are guaranteed to have licenses available any time. NOTE: Concurrent licenses can be borrowed for use without a network connection. For details, see Online/Offline Mode and Concurrent License Checkout. For a detailed description of licensing options, see DBARTISAN LICENSE MODULES, DBMS SUPPORT, AND FEATURE AVAILABILITY Individual license modules correspond to the DBMS platforms you are licensed to use. In addition, each DBMS license module corresponds to a product edition. Feature availability for each license module edition is as follows: Standard - Provides baseline support including datasource management, object management, SQL editing and execution, and standard tools and utilities. Professional - Standard edition features plus SQL Debugger and SQL Profiler. Workbench - Professional edition features plus Performance Analyst, Space Analyst, Capacity Analyst, and Backup Analyst. DBARTISAN XE LICENSE MODULES, DBMS SUPPORT, AND FEATURE AVAILABILITY An XE license provides access to all supported DBMS platforms. XE modules and feature availability are as follows: XE Pro - Provides baseline support including datasource management, object management, SQL editing and execution, and standard tools and utilities, SQL Debugger and SQL Profiler. Analyst Pack - Provides access to Performance Analyst, Space Analyst, Capacity Analyst, and Backup Analyst. DIRECTING QUERIES REGARDING LICENSES Questions regarding license availability, feature availability, and client or server licensing, should be directed as follows: If you work in an organization that uses networked licensing, direct any questions to your site s DBArtisan administrator If you are using workstation licensing, direct licensing questions to your Embarcadero Technologies representative 12 DBARTISAN XE 2/9.0 QUICK START GUIDE

13 INSTALLING DBARTISAN LICENSING YOUR APPLICATION See the following topics for details on registering your product: Registering a trial or workstation license during installation Registering a workstation license after application startup Registering by phone Registering a networked license REGISTERING A TRIAL OR WORKSTATION LICENSE DURING INSTALLATION Shortly after initiating download of a trial version of an Embarcadero product, you should receive an with a serial number you must register during installation. Similarly, if you purchase an Embarcadero product while no trial version is active, you will receive a serial number that must be registered during installation. 1 Start the installation. An Embarcadero License Registration dialog appears. 2 Copy the serial number from the and paste it in the Serial Number field. 3 Enter your Embarcadero Developer Network account credentials in the Login or and Password fields. If you have not previously created an EDN account, or have forgotten your password, click I need to create... or I ve lost my password. 4 Click Register. Your activation file should be downloaded and installed automatically. If this does not happen, click the Trouble Connecting? Try Web Registration link and follow the prompts. If you still have problems, see Registering by phone. REGISTERING A WORKSTATION LICENSE AFTER APPLICATION STARTUP The following instructions assume that you have received a workstation license by and that you currently have a valid trial license. If you did not install a trial version or the trial period has expired, follow the instructions in Registering a Trial or Workstation License During Installation instead. 1 On the Help menu select About and then on the dialog that opens, click Manage to open a license manager dialog. 2 On the Serial menu, select Add. 3 Copy the serial number from the and paste it in the Add Serial Number dialog, then click OK. 4 Right-click on the serial number you added, and then select Register from the context menu. A registration dialog opens. NOTE: The Registration Code box shows a machine-specific identifier required with other registration methods. DBARTISAN XE 2/9.0 QUICK START GUIDE 13

14 INSTALLING DBARTISAN 5 Ensure that the Register using Online Registration radio box is selected. 6 Provide Developer Network credentials in the DN Login name or and DN Password boxes. If you have not previously created an EDN account, or have forgotten your password, click I need to create... or I ve lost my password. 7 Click Register. 8 If prompted to restart the application, click Yes. Your activation file should be downloaded and installed automatically. If this does not happen, click the Trouble Connecting? Try Web Registration link and follow the prompts. If you still have problems, see Registering by phone. REGISTERING BY PHONE If you have problems with either of the above procedures, you can register licenses by phone. You will have to provide Developer Network credentials; the registration code displayed in the Embarcadero License Registration dialog that appears when you start an unlicensed application; the product base license serial number; and the license serial numbers for any additional features you have purchased. For North America, Latin America and Asia Pacific, call (415) option 2 and then follow the prompts. The hours are Monday to Friday, 6:00 A.M. to 6:00 P.M. Pacific time. For Europe, Africa and the Middle East, call +44 (0) The hours are Monday to Friday, 9 A.M. to 5:30 P.M. U.K. time. Shortly after phoning in, you will receive an containing an activation file. Then do the following: 1 Save the file to the desktop or a scratch directory such as c:\temp. 2 On the Help menu select About and then on the dialog that opens, click Register. A registration dialog opens. 3 Select the I have received an activation file (*.slip or reg*.txt) radio box. 4 Click the Browse button and use the Select License Activation File dialog to locate and select the activation file you installed. 5 Click the Import button to import the activation file and when complete, click the Finish button. 6 If prompted to restart the application, click Yes. REGISTERING A NETWORKED LICENSE If you work in an organization using Networked licensing, an administrator, department head, or someone providing a similar function will provide you with an activation file. 14 DBARTISAN XE 2/9.0 QUICK START GUIDE

15 INSTALLING DBARTISAN Once you receive the file, save it to the license subfolder of your product s main installation folder (typically C:\Program Files\Embarcadero\<product><version>\license\), then restart the application. No additional steps are necessary. SELECTING A LICENSE CATEGORY DURING STARTUP During DBArtisan startup, if multiple concurrent license categories are available, you are prompted to select a category to use for this DBArtisan session. Multiple license categories can be set up to provide differing feature access or access to different DBMS versions. Feature and DBMS version access are typically distributed across multiple license categories to optimize use of a site s purchased licenses. NOTE: This dialog also includes the option to remember your selection on subsequent startups. If you select that option, you can subsequently use the Select Licenses button on the About... dialog (Help > About) to select a different license. Contact your License Administrator for details on individual license categories or requests for additional feature or DBMS support. ONLINE/OFFLINE MODE AND CONCURRENT LICENSE CHECKOUT Concurrent licenses can be used in both online and offline modes. In online mode, you must have a continuous network connection to your License Center. Licenses are checked out when you start DBArtisan and checked back in when you shut DBArtisan down. You can also use a license in offline mode. When you explicitly check out a license for offline use, you can use DBArtisan without a connection to your License Center for a specified duration. This lets you work while travelling or commuting, work away from your primary work area, or use DBArtisan when a network connection is unavailable or not required. NOTE: Contact your site administrator for information on offline license availability, the maximum duration, offline license policy at your site, or any other issues arising from online license usage. To check out a license for offline use: 1 On the Help menu, select Checkout License. The Check Out Licenses For Offline Use dialog opens. 2 Select the check box associated with each individual license you want to check out. 3 In the Checkout Duration box, type the number of hours that you can use the offline license without a network connection to the License Center. 4 Click OK. You can work offline for the specified duration. The duration period begins immediately. DBARTISAN XE 2/9.0 QUICK START GUIDE 15

16 ADDITIONAL PRODUCT RESOURCES If you subsequently establish a network connection to the License Center before the license duration expires, you can indicate to the License Center that the offline license is no longer required. To indicate that an offline license is no longer required: 1 On the Help menu, select Checkin License. There is no interruption in DBArtisan usage. The license is not actually checked in until you shut down DBArtisan. ADDITIONAL PRODUCT RESOURCES The Embarcadero Web site is an excellent source for product information and access to additional resources: Release notes and product documentation Information on other Embarcadero application and database development tools Embarcadero Development Network Product and technical support Educational and product expertise material in the form of online demos, white papers, and video presentations Access to sales staff and Embarcadero resellers For access, direct your browser to 16 DBARTISAN XE 2/9.0 QUICK START GUIDE

17 TUTORIAL EXERCISES The exercises that follow walk you through the DBArtisan s major functional areas. After completing these exercises, you will have the foundation you need to explore the many features and benefits of DBArtisan. You ll have learned how to competently manage the major database administration disciplines using DBArtisan s standard cross-platform console. In addition, you will have a solid understanding of DBArtisan s more advanced Space, Performance, and Capacity management capabilities. This guide is divided into 10 sessions: Session 1: Getting Started with DBArtisan Session 2: Object and Schema Management Session 3: Database Security Management Session 4: Space Management Session 5: SQL Management Session 6: Job Management Session 7: Data Management Session 8: Performance Management Session 9: Capacity Management Session 10: General Utilities and Tools You can use this basic tutorial as a roadmap of product highlights, but also to help you find your own path to explore DBArtisan. Once you ve started, you can select Help Topics from the Help menu to find many additional resources that complement and build on many of the activities shown in this tutorial. SESSION 1: GETTING STARTED WITH DBARTISAN How you start DBArtisan depends on the type of application you are evaluating: InstantOn version start the application by double-clicking the file you downloaded. Fully-installed version - The Start menu sequence for DBArtisan is always in the form Programs > Embarcadero DBArtisan version identifier > Embarcadero DBArtisan version identifier, where version identifier reflects the version you are running. DBARTISAN XE 2/9.0 QUICK START GUIDE 17

18 To get started 1 Run DBArtisan. The first time DBArtisan starts, a dialog opens, prompting you to set up datasources. In addition to letting you manually set up individual datasources, a number of more automated methods are available. If you have installed and used other Embarcadero tools, DBArtisan can find any active datasources being used by those tools. In addition, DBArtisan provides a Discover Datasources feature that automatically searches the DBMS configuration files on your system for datasources that are not currently registered. Since other Embarcadero tools let you export datasource definitions to file, you also have the option of importing these definitions. 2 For the purpose of this tutorial, click Cancel. You will be registering a datasource manually. REGISTERING CROSS-PLATFORM DATASOURCES The Datasource Registration Wizard walks you through the process of registering a datasource for use with DBArtisan. 1 On the Datasource menu, select Register Datasource. DBArtisan opens the wizard, initially prompting you for the DBMS type. 2 Select Oracle as the database type and then click Next. DBArtisan opens the next panel of the Datasource Registration Wizard. 18 DBARTISAN XE 2/9.0 QUICK START GUIDE

19 3 Ensure that Use TNS Names Alias is deselected and provide the Host machine name associated with an Oracle datasource. 4 Type a Port number. The default is 1521, but you can change it to wherever the Oracle listener is set up. 5 Specify a Type of SERVICE_NAME or SID and enter the corresponding value in the SID/ Service box. 6 In the Datasource Name text box, type SAMPLE_DATASOURCE for the purpose of this example. 7 Click Next. DBArtisan saves your selections and opens the next panel of the wizard. This is where you enter login credentials. 8 Provide a User ID and Password. 9 To save and encrypt your password so that you do not have to provide credentials each time you connect, select Auto-Connect?. 10 Click Next. DBArtisan saves your selections and opens the next panel of the wizard. DBArtisan s SQL Editor supports directives similar to C compiler directives. This panel lets you specify directories that will be searched when a #include directive is encountered. You can leave the field blank for now. 11 Click Next. DBArtisan opens the final panel of the wizard. 12 In the Managed Datasources tree, select the folder corresponding to the type of DBMS you are registering. 13 Click Finish. DBArtisan prompts you as to whether you want to connect to the datasource. 14 Click Yes. DBArtisan offers the same easy-to-use Datasource Registration Wizard for IBM DB2, Microsoft SQL Server, Oracle, MySQL, and Sybase connections. The connection information only needs to be set up one time for each datasource and can be saved locally or in a common datasource catalog for use by other Embarcadero products. You can configure Embarcadero database applications to use a datasource catalog stored in the system registry of your machine (local) or to use a datasource catalog located in the registry of another computer (remote). This capability makes it easy to share datasource catalogs among multiple users so that maintenance can be administered from one location. All Embarcadero database administration products share the datasource catalog, which means that when you set up your datasource catalog using one product such as DBArtisan, the same list of datasources is available in other Embarcadero Technologies products. Any changes you make to the datasource catalog are reflected in all Embarcadero database management products. DBARTISAN XE 2/9.0 QUICK START GUIDE 19

20 GENERAL USABILITY FEATURES DBArtisan provides many user in mind features that make the product configurable to meet individual needs and preferences. These features are designed to shave time off the tasks that you perform many times on any given working day. Retaining Datasource Explorer View Settings 1 At the top of the Explorer tree, click to expand the drop-down menu. 2 Select Retain View Settings. The next time you open DBArtisan, the Explorer appears just as you left it. 20 DBARTISAN XE 2/9.0 QUICK START GUIDE

21 Working with Datasource Explorer Bookmarks 1 In the Explorer tree, right-click the datasource you registered and select Add Bookmark from the context menu. DBArtisan opens the Add Friendly Bookmark Name dialog box. 2 Click OK. After Bookmarks are defined you can use them to easily navigate to commonly used datasource resources via the main menu Bookmarks item. DBARTISAN XE 2/9.0 QUICK START GUIDE 21

22 Setting Keyboard Shortcuts and Hotkeys 1 From the Tools menu, select Customize. The Customize dialog box opens. 2 In the Customize dialog box, open the Keyboard tab. The Keyboard tab can be used to set keyboard shortcut hot keys for all areas of DBArtisan functionality. 3 Click Close. Datasource Explorer tree filtering DBArtisan provides a number of ways to filter the Datasource Explorer tree, easing navigation. During a DBArtisan session, you can use the Filter box at the top of the Datasource Explorer to display only those objects whose name contains characters typed in the Filter box. 22 DBARTISAN XE 2/9.0 QUICK START GUIDE

23 If you are interested in a more permanent filtering method, you can create filters at the DBMS or datasource level. Filters are available under the Filters node for each datasource. Right-clicking in the tree and selecting Filter opens the Filters dialog. It lets you filter out object types at the DBMS platform level. It also lets you create object filters. Object filters can be object name-based, schema-based, or some combination thereof. A name-based or schema-based filter consists of one or more ANDed conditions. You also specify the object types to which the filter is to apply. DBARTISAN XE 2/9.0 QUICK START GUIDE 23

24 Object filters are created at the DBMS or datasource level and can be enabled and disabled for individual datasources. The Filters dialog also lets you hide or display nodes based on object type. Node filtering lets you filter out object types for all datasources of the same DBMS type. 24 DBARTISAN XE 2/9.0 QUICK START GUIDE

25 In addition to any custom object filters you create, the Filters node also provides access to two default filters: Ignore System Objects and Show Only My Objects. They can be applied at the datasource level and cannot be deleted or modified. SESSION 2: OBJECT AND SCHEMA MANAGEMENT DBArtisan provides unparalleled database object management capabilities. Its database platform-specific and version-specific graphical object editors and wizards enable you to easily create, drop or alter any of your accessible database objects. CREATING A TABLE OBJECT The following example walks you through creating a standard Oracle table object. This concept carries across all of the supported object types, across all of the supported platforms. 1 On the Datasource Explorer, expand the Schema node of an Oracle datasource. 2 Right-click the Tables node, and then select Create. 3 DBArtisan opens the Table wizard and leads you through the process of creating a table object. DBARTISAN XE 2/9.0 QUICK START GUIDE 25

26 4 Complete the wizard panels, and ensure that you create two or more columns in the table. 5 Click Finish. DBArtisan lets you preview any and all generated scripts before you submit them to the database. This is standard for all object-related scripts. MAKING CHANGES TO AN EXISTING TABLE OBJECT Changes to database tables, such as modifying column lengths, inserting new columns, or deleting unneeded ones, can require dropping of a table. This requires knowledge of the underlying object dependencies so that these dependent objects are rebuilt after the table has been recreated. DBArtisan provides the ability to perform extended table alterations by constructing a SQL script with the steps necessary to save off the original data, create the new table, and populate it with the original data. Once these steps are complete, all dependent objects are then rebuilt and permissions re-applied. 1 From the Explorer, Tables node, select the table you created in the previous example. 2 Double-click the table or from the Command menu, click Open. DBArtisan opens the Table Editor. The Table Editor provides access to basic table properties, the list of table columns as well as any constraints, storage parameters, space allocation, partitioning, table dependencies, object privileges, table DDL and other attributes of the table. 26 DBARTISAN XE 2/9.0 QUICK START GUIDE

27 3 Ensure that the Columns tab is selected and select one of the columns you created in this table you want to modify. Details for the column are shown in the Column Attributes area on the right side of the pane. 4 In the Width or Scale text box, type a new value. 5 On the Table Editor toolbar, select the Alter button. DBArtisan lets you preview the SQL script before you submit it to the database. 6 Close the Table Editor pane. WORKING WITH OBJECT DDL DBArtisan allows you to easily extract DDL for single or multiple objects using several methods. The most straight-forward is described here: 1 On the Explorer, right-click the table you created earlier, and then select Extract. The DDL for all highlighted objects is extracted directly in a DDL Editor where it can be altered, executed and saved to the database, with no intermediary steps required. For example: 2 Close the PL/SQL Editor pane. DBARTISAN XE 2/9.0 QUICK START GUIDE 27

28 SESSION 3: DATABASE SECURITY MANAGEMENT DBArtisan can help you efficiently establish and maintain database security. Whether you are managing an existing production database or setting up a new environment, you ll find consistent support across all of the supported platforms. ADDING A NEW DATABASE USER While this example focuses on creating a new Oracle user, the same wizard-driven principle applies to all security objects (groups, roles, etc). 1 On the Datasource Explorer, expand an Oracle datasource, and then the Security node. 2 On the Security node, right-click Users, and then click Create. DBArtisan opens the User Wizard and leads you through the process of adding a user. 3 Provide the information on each panel of the User Wizard until you reach the DDL View panel. DBArtisan allows you to preview any and all generated scripts before they are submitted to the database. This is standard for all object-related scripts. 4 Click Execute to create the new user. DBArtisan automatically opens the User Editor for the new user. The standard User Editor can be used to manage existing database users as shown below. 28 DBARTISAN XE 2/9.0 QUICK START GUIDE

29 GRANTING AND EDITING USER PRIVILEGES Privileges can be easily granted, revoked, or viewed from within either of two editors within DBArtisan; the User Editor, or the individual object editor (Table, Procedure, etc.) The User Editor provides a tabbed interface, which can be used to view and modify individual attributes of the user. 1 In the User Editor, open the Object Permissions tab. 2 Use the Object Type dropdown to select a set of objects such as tables or views. 3 Right-click a cell (corresponding to a specific object and a specific permission, such as DELETE), and then click Grant. A distinctive icon is shown in the cell, indicating that this permission is granted. You use a similar process to revoke privileges and perform other permission-based activities. 4 On the Object Editor toolbar, click Alter to implement the changes. SESSION 4: SPACE MANAGEMENT Managing space is vital to ensuring the availability and performance of your databases. DBArtisan incorporates many built-in space features that let you smartly manage and exploit all aspects of your database s storage. The following example walks you through a review of DBArtisan s built-in support for reporting Oracle tablespace storage and space data. BUILT-IN SPACE MANAGEMENT While this example is specific to Oracle tablespaces the same concept applies to all of the supported platforms. 1 On the Datasource Explorer, expand any Oracle datasource. 2 On the Oracle datasource, expand the Storage node, and then select Tablespaces. 3 Right-click any tablespace listed in the right pane of the Explorer window, and then click Open. Embarcadero DBArtisan opens the Tablespaces Editor. 4 Select the Properties tab. The Storage group on that tab provides a summary of the space settings for the tablespace. DBARTISAN XE 2/9.0 QUICK START GUIDE 29

30 5 Select the Extent Details tab. It provides more detail on an extent-by-extent basis. 6 On the Tablespace Editor, click the Space tab. The Space tab displays a graphical view of the free and used blocks for the target tablespace. 30 DBARTISAN XE 2/9.0 QUICK START GUIDE

31 7 Finally, on the Tablespace Editor, click the Map tab. The Map tab displays a color-coded map of the objects contained on the tablespace. The map segments are proportional to the actual size of the objects on the tablespace. Note the additional Reorganize and display options. 8 Close the Tablespaces Editor pane. DBARTISAN XE 2/9.0 QUICK START GUIDE 31

32 ADVANCED SPACE MANAGEMENT (ORACLE AND SQL SERVER ONLY) For advanced space analysis and management, DBArtisan s optional Space Analyst component contains sophisticated diagnostics to help you pinpoint all space-related problems in your database, as well as an intelligent reorganization wizard that can reorganize all or selected parts of your database. NOTE: Space Analyst is a separately-licensed component. If you are not working with an evaluation copy of DBArtisan or do not have a specific license, procced to Session 5: SQL Management. Contact your license administrator or your Embarcadero representative about obtaining a license. To see the sort of information provide by the Space Analyst 1 On the Analyst menu, select Space Analyst. NOTE: If prompted to install components on the server, allow DBArtisan to install the components. The Space Analyst launches in the DBArtisan workspace. 32 DBARTISAN XE 2/9.0 QUICK START GUIDE

33 Embarcadero s Space Analyst provides sophisticated diagnostic capabilities to troubleshoot bottlenecks and performance inefficiencies that result in poor space management. See the DBArtisan online help for a detailed walkthrough of all available features and functionality. 2 Select the Data Files, Tablespace Map, Tables, and Indexes tabs available at the bottom of the Space Analyst pane. 3 Close the Space Analyst pane. SESSION 5: SQL MANAGEMENT DBArtisan provides powerful visual tools for creating and analyzing complex SQL statements and server-side code objects. The following examples walk you through DBArtisan s Visual Query Builder, feature-rich ISQL facility and some of the advanced analysis and debugging capabilities provided by the Embarcadero SQL Debugger and SQL Profiler. VISUAL QUERY BUILDER 1 From the Tools menu, select Query Builder. DBArtisan opens the Query Builder. 2 In the Tables/Views tab, right-click a table or view and select Add. 3 In the window that opens, select the columns to return in the result. For example: Query Builder generates the query text in the lower SQL window. DBARTISAN XE 2/9.0 QUICK START GUIDE 33

34 You can build advanced queries using the options supplied on the DML tab. You choose the type of query (SELECT, INSERT, and so on) using the dropdown on the Query Builder toolbar. 4 After the query is built, click the Execute button (green arrow) on the Query Builder toolbar. Query Builder displays results in the lower SQL window. 5 Close the Query Builder pane. ISQL WINDOW DBArtisan offers a fully-featured SQL editor. In addition to basic text processing features, the editor environment offers testing/debugging and execution facilities. In combination with supporting features, the ISQL editor eases and speeds up the process of developing working scripts. AUTOMATED ERROR DETECTION AND CODING ASSISTANCE DBArtisan provides a range of features that detect or help you avoid errors and save keystrokes in developing your scripts. To enable these features: 1 On the File menu select Options. The Options dialog opens. 2 In the left-hand pane, expand the ISQL node and then select Code Assist. 34 DBARTISAN XE 2/9.0 QUICK START GUIDE

35 3 On the Code Assist panel: Ensure that Enable Code Complete is selected. Ensure that Enable Real-time syntax checking is selected. Ensure that Severity levels for semantic validation problems has Warning selected. 4 Click OK. To see these features in action: 1 On the File menu, select New > ISQL. DBArtisan opens the ISQL Editor window. You can add SQL code via your method of choice (free-form typing, retrieve from a file, paste copied code, etc.). 2 Experiment with the automated error detection and coding assistance as follows: Type SELECT * FROM and stop typing. Note the error condition. By default, DBArtisan runs a syntax check any time there is an interval of 1.5 seconds between keystrokes. You can also disable automatic syntax checking and only run a check when you manually initiate it. Syntax error annotation persists until you correct the problem. This time type a fragment that includes the name of a nonexistent object, SELECT * FROM NON.OBJECT, for example. For now, ignore any popups. The warning condition is a result of on-the-fly semantic validation. DBArtisan notifies you when a script contains a reference to an object that DBArtisan cannot resolve. Type SELECT * FROM followed by a space and then stop typing. If no popup appears, press CTRL+SPACE. The Code Complete suggestion box lets you select from objects or object name components such as databases or schema. This feature saves keystrokes and minimizes typing errors. See the online Help for full descriptions of these features. 3 If you want to disable the automated errror detection and coding assistance features, select File > Options and on the Code Assist page, click Restore defaults. FEATURE SUMMARY The ISQL Editor window includes the following features and options: The ISQL window highlights all platform-specific and general keywords, and provides options for SQL code formatting and analysis. Once code is executed you have control over whether your transaction is committed or rolled back from the database. For all open ISQL windows, there are also options for connection locking, scheduling, executing your code across multiple datasources, explain plan generation, and SQL Tuning. DBARTISAN XE 2/9.0 QUICK START GUIDE 35

36 SETTING ENVIRONMENT OPTIONS DBArtisan lets you set platform-specific query options to immediately determine if your code is optimized. 1 Press F8. DBArtisan opens the Query Option dialog box. For example, when connected to a SQL Server datasource, the Query Options dialog offers the following options. 2 Either close the Query Options dialog and then the SQL Editor window or enter a valid query in the ISQL editor and then execute your query by clicking the Execute button. 3 When complete, ensure that only the Datasource Explorer window is open. SQL DEBUGGING, ANALYSIS AND TUNING To analyze and debug your SQL code, DBArtisan provides cross-platform SQL code debuggers, and for your Oracle databases, a robust PL/SQL code profiler that helps you to pinpoint and eliminate hot spots within poorly running server-side code. To ensure code efficiency, the ISQL window provides tight integration with Embarcadero s SQL Tuner, so you can perform multiple test then tune iterations without having to leave an open ISQL window. While this example is specific to Oracle PL/SQL Debugging, the same interface and functionality applies to all of the supported platforms. To see debugging in action 1 On the Datasource Explorer, expand any Oracle datasource node. 2 On the Oracle datasource, expand the Procedures node. 36 DBARTISAN XE 2/9.0 QUICK START GUIDE

37 3 In the right pane of the Explorer, right-click any stored procedure, and then select Debug. 4 If prompted, enter any input parameters and then click Continue. After the SQL Debugger interface is displayed you can step through code, step into dependencies, set and watch variables, and even perform basic code profiling for each line of executed code. See the DBArtisan online help for a detailed listing of all available SQL features. 5 Experiment with debugging features and then close the debugger window. SESSION 6: JOB MANAGEMENT DBArtisan freely integrates with the Microsoft Windows Task Scheduler, which allows you to virtually schedule any task to run on your own computer whenever and how often you d like. While this example is specific to an Oracle table redefinition, the same concept applies to any job or script that can be scheduled. To schedule a job, do the following: 1 On the Explorer, expand any Oracle datasource. 2 On the Oracle datasource, expand the Tables node, right-click any table, and select Extract. DBArtisan extracts the DDL that defines the selected table and opens an ISQL Editor window on the DDL. 3 From the ISQL window toolbar, click the Schedule button. The Schedule Action dialog box opens. You can provide a name, set notifications, and specify an output directory for the new job. DBARTISAN XE 2/9.0 QUICK START GUIDE 37

38 4 After you have completed the dialog box, click OK. The Job Scheduler dialog opens. 5 Proceed as prompted to schedule your job. When finished, close the ISQL window. You can use the Oracle Job Queue explorer node to monitor your job.. SESSION 7: DATA MANAGEMENT DBArtisan provides comprehensive facilities to help you manage the data in all of your databases. A visual data editor helps you add, change, and delete data from your tables with all referential integrity enforced. You can create insert statements for tables using current data and also extract data as XML documents for certain databases. Rounding out its rich Schema Management capabilities, DBArtisan also allows you to migrate schema objects and associated table data from one database server to another, across the same or different platforms. VISUAL DATA EDITING To start the Visual Data Editor, do the following: 1 In the Datasource Explorer, right-click any table and select Edit Data. DBArtisan opens the Data Editor Filter dialog. 2 In Columns, select the columns that are to be included in the editable data. 38 DBARTISAN XE 2/9.0 QUICK START GUIDE

39 You can also filter the editable rows by including your own SELECT statement. 3 Click OK. In Live mode all changes are applied to the database when you move off of an updated or inserted row. Deleted rows are immediately removed from the database. Batch mode allows you to make changes and then save all when all are complete. Mode is controlled by a dropdown in the Data Editor toolbar. 4 Experiment with editing your data, and when complete, on the Data Editor toolbar, click the Execute (blue arrow) button. DBArtisan commits your changes. Regardless of mode, all of the generated DML statements are viewable in the lower SQL window. 5 Close the Data Editor pane. DBARTISAN XE 2/9.0 QUICK START GUIDE 39

40 WORKING WITH TABLE DATA CREATE INSERT STATEMENTS DBArtisan lets you generate a set of INSERT statements based on rows of an existing table. 1 On the Datasource Explorer, select any Oracle datasource. 2 On the Oracle datasource, expand the Tables node. 3 In the right pane of the Explorer window, right-click any table, and then select Create Insert Statements. DBArtisan opens the Create Insert Statements dialog box. For example: 4 In Columns, select the columns you want to include in the INSERT statement. 5 You can also filter what rows are included by adding your own WHERE clause. 6 Click OK. The resulting INSERT statements are created and presented in an active ISQL window. At this point they can be executed immediately, scheduled to later or saved. Note that all extracted INSERT statements can be run against the same or different databases containing a similar schema. 40 DBARTISAN XE 2/9.0 QUICK START GUIDE

41 7 Close the editor pane. WORKING WITH TABLE DATA EXTRACT DATA AS XML DBArtisan lets you generate an XML representation of table data. To extract data as XML 1 On the Datasource Explorer, expand any Oracle datasource. 2 On the Oracle datasource, expand the Tables node. 3 In the right pane of the Explorer window, right-click any table listed, and then select Extract Data as XML. 4 Select the columns to include in the SELECT statement. 5 You can also filter what rows are included by adding your own SELECT statement. 6 Click OK. The resulting XML document is created and presented in an active XML Editor. At this point the document can be saved in XML format. DBARTISAN XE 2/9.0 QUICK START GUIDE 41

42 7 Close the editor pane. ADVANCED DATA MANAGEMENT SCHEMA AND DATA MIGRATION DBArtisan provides advanced data management tools that help you to move schema and corresponding table data across the same or different platforms. You can copy a single database object, all objects owned by a specific user, or an entire database all guided by a wizard-driven process. While this example is specific to an Oracle to SQL Server schema and data migration the same concept applies to any migration involving any combination of the supported platforms. To open the Schema Migration Wizard: 1 On the Utilities menu, select Schema Migration. DBArtisan opens the Migration Wizard. 2 Select the Perform new migration option. 3 Click Next. DBArtisan opens the next panel of the Migration Wizard. For example: 42 DBARTISAN XE 2/9.0 QUICK START GUIDE

43 4 Select an Oracle datasource from the Source Datasource list and a Microsoft SQL Server datasource from the Target Datasource list. 5 Click Next and provide login credentials if prompted. DBArtisan opens the next panel of the Migration Wizard. Since Microsoft SQL Server supports multiple databases per datasource, you must choose a database. 6 Select an entry from the Target Database list and then click Next. DBArtisan opens the next panel of the Migration Wizard. DBARTISAN XE 2/9.0 QUICK START GUIDE 43

44 7 In the Object Types list, select the object types to be migrated to the target datasource. As you select object types, the Objects list is updated to let you select specific objects to migrate. The Expand/Collapse icons let you drill down through dependencies/ containment. 8 Use the Objects list to select the specific objects to migrate. 9 Click Next. DBArtisan opens the next panel of the Migration Wizard. 44 DBARTISAN XE 2/9.0 QUICK START GUIDE

45 10 Examine the migration options offered but leave the default settings for now. 11 Click Next. DBArtisan opens the next panel of the Migration Wizard. Clicking Finish executes the migration and lets you view the progress of the job. SESSION 8: PERFORMANCE MANAGEMENT DBArtisan offers a number of different options to help you manage the performance of your databases. First, DBArtisan ships with a built-in process monitor that helps you understand who is connected to your database along with each user s current activity and session-related data. For more robust performance details DBArtisan s Performance Analyst add-on is a powerful client-side database monitor that runs fully contained in the DBArtisan console. DBARTISAN XE 2/9.0 QUICK START GUIDE 45

46 MONITORING SESSIONS While this example is specific to Oracle the Process Monitor is available for all of the supported platforms. To start the DBArtisan Process Monitor: 1 On the Datasource Explorer, select any Oracle datasource. 2 From the Utilities menu, select Database Monitor. The Database Monitor includes the following options and features: Highlight any session and any currently running SQL is displayed in the lower pane. You can drill-down into a specific session to display session-level statistical details, historical and current wait events along with a working copy of the currently running SQL that can be copied to an ISQL for explain plan generation. By using the Monitor dropdown options you can display more advanced database-level monitoring data such as locks, blocking locks, hit ratio by user, Top 20 SQL etc. 46 DBARTISAN XE 2/9.0 QUICK START GUIDE

47 3 Close the Database Monitor pane. DBARTISAN XE 2/9.0 QUICK START GUIDE 47

48 ADVANCED CLIENT-SIDE PERFORMANCE MONITORING For advanced performance monitoring and management, DBArtisan s optional Performance Analyst provides intelligent diagnostic information and strong drilldown details to help you get to the heart of any episode of performance degradation. Performance Analyst integrates completely with DBArtisan so you can fix any performance problems with a few clicks of the mouse. NOTE: Performance Analyst is available for Oracle, SQL Server, Sybase and DB2 for Unix, Windows, and Linux. NOTE: Performance Analyst is a separately-licensed component. If you are not working with an evaluation copy of DBArtisan or do not have a specific license, procced to Session 10: General Utilities and Tools. Contact your license administrator or your Embarcadero representative about obtaining a license. 1 On the Datasource Explorer, select any Oracle datasource. 2 On the Analyst menu, select Performance Analyst. The Performance Analyst opens in the DBArtisan workspace for the target datasource. In addition to the Home page displayed initially, Performance Analyst presents several pages of statistics. Page categories include Memory, I/O, Space, Objects, Users, and OS. Each page contains several panes of related statistics, the Home page s Key Ratio Analysis pane, for example: Note the toolbar at the top of the Performance Analyst. It lets you navigate among the Performance Analyst statistics pages. 3 Experiment with displaying the various pages available from the toolbar dropdowns. See the DBArtisan online help Performance Analyst topics for a detailed walkthrough of all available features and functionality. 48 DBARTISAN XE 2/9.0 QUICK START GUIDE

49 For enterprise performance monitoring, DBArtisan integrates with the Embarcadero Performance Center Web Client. While integration requires a licensed Performance Center server, there are no upgrade requirements for the DBArtisan console. NOTE: You should only work through the following exercise if you are a current Performance Center user. If you are not a Performance Center customer, please read the following for information purposes only. Use the following to establish a quick connection to your Performance Center server: 1 On the File menu select Options. 2 On the Options Editor, select the Perf Center tab. 3 Select the Web Client radio button and enter the Performance Center server info as indicated. 4 Perform a test to ensure the configuration is correct. 5 After a connection is established you can use the Tools > Performance Center option to launch the Web Client within the DBArtisan console. If you are using the full Performance Center client you can use this same Options editor tab to switch back. NOTE: The Performance Center web client provides read-only access to the monitored datasources. To perform edits or maintenance you must switch to the full Performance Center client. Please see the relevant DBArtisan online help topics for a detailed walkthrough of all available features and functionality. DBARTISAN XE 2/9.0 QUICK START GUIDE 49

50 SESSION 9: CAPACITY MANAGEMENT Planning for the future of your critical databases used to be a difficult task. However, DBArtisan s optional Capacity Analyst tool makes it easy to understand where your databases are today and where they are headed in the future. Capacity Analyst lets you track key database metadata and performance metrics over time so you can perform trend analysis on key areas like growth, object fragmentation, I/O and session load. Like all of the Analyst Series products, Capacity Analyst runs fully contained within DBArtisan so you have access to smart, built-in forecasting mechanisms that allow you to predict when your databases run out of space and the ability to proactively manage your storage assets, all from the same console. Performance Analyst is available for DB2 for Unix, Windows, and Linux, Sybase, Oracle, and SQL Server. 1 On the Datasource Explorer, select any Oracle datasource. 2 From the Analyst menu select Capacity Analyst. NOTE: Capacity Analyst is a separately-licensed component. If you are not working with an evaluation copy of DBArtisan or do not have a specific license, procced to Session 10: General Utilities and Tools. Contact your license administrator or your Embarcadero representative about obtaining a license. The Capacity Analyst opens in the DBArtisan workspace for the target Oracle datasource. See the relevant DBArtisan online Help topics for a detailed walkthrough of all available features and functionality. 50 DBARTISAN XE 2/9.0 QUICK START GUIDE

51 SESSION 10: GENERAL UTILITIES AND TOOLS No evaluation of DBArtisan would be complete without a mention of the general utilities and tools that are available across all of the supported platforms. The Utilities menu offersprimarily DBMS-specific operations while those offerd on the Tools menu are more generic. The Utilities menu contains the more advanced DBArtisan features. The available menu items are context-sensitive and version-specific for the selected datasource DBMS platform. This example above shows the Utilities menu features that are available for Oracle. The Tools menu contains those features that are common across all DBMS platforms. Te example above shows the Tools menu features that are available for all supported DBMS platforms. Note that if any other Embarcadero products are installed on your client they will be available on the Tools menu. All DBArtisan utilities and tools provide a common interface that walks you through all input and execution requirements. All results are consistently presented so you can easily move between features without effort or confusion. DBARTISAN XE 2/9.0 QUICK START GUIDE 51

52 52 DBARTISAN XE 2/9.0 QUICK START GUIDE

53 NEW FEATURES This release introduces new or updated features in the following categories: Updated DBMS Version Support SQL Server Feature Support Oracle Feature Support Sybase Feature Support DB2 z/os Feature Support Datasource/Server Updates Unicode updates SQL Editor Performance Analyst Updates User interface changes and related features UPDATED DBMS VERSION SUPPORT DBArtisan now provides support for IBM DB2 for Linux, Unix, and Windows version 9.7. All current DBArtisan functionality is now available on this platform version. SQL SERVER FEATURE SUPPORT The following topics describe updated support for SQL Server features. Synonym Support This release introduces support for SQL Server synonyms. You can now create a one-part object name used in SQL statements to reference a partially-qualified to fully-qualified, multi-part object name. A new wizard and editor are provided and a basic set of object operations is also available. DBARTISAN XE 2/9.0 QUICK START GUIDE 53

54 NEW FEATURES Fixed Server Role Login Member Assignment A new Server Roles Editor lets you modify the login membership of SQL Server s fixed server roles: bulkadmin, dbcreator, diskadmin, processadmin, securityadmin, serveradmin, setupadmin, and sysadmin. Table and Index Partitioning This release introduces support for table and index partitioning on SQL Server. Both Wizards/ Editors now include a Partitioned property that enables partitioning, and a Partition Scheme property used to reference a new object type that lets you specify a file group mapping. The Partition Scheme, in turn, references another new object type, a Partition Function, that maps the rows of a table or index into partitions based on values of a specified column. 54 DBARTISAN XE 2/9.0 QUICK START GUIDE

55 NEW FEATURES A full set of Wizards, Editors, and object operations are available for the new object types. Full-text Search Support Full-text Catalogs and Full-text Indexes are now supported object types in DBArtisan, letting you set up the indexes that aid linguistic/proximity searches and the files to store those indexes. A set of associated object actions let you rebuild catalogs, merge smaller indexes, enable and disable indexes, and provide native control options for index population. DBARTISAN XE 2/9.0 QUICK START GUIDE 55

56 NEW FEATURES DDL Triggers DBArtisan now provides support for SQL Server DDL Triggers. These triggers fire in response to DDL events. Support provided is as follows: Database Trigger object type - builds and submits CREATE TRIGGER... ON DATABASE statements Server Trigger object type - builds and submits CREATE TRIGGER... ON ALL SERVER statements A Change Status object action lets you enable or disable triggers. ORACLE FEATURE SUPPORT The following topics describe updated support for Oracle features. ASM Disk Group support For Oracle datasources that have an ASM instance, DBArtisan now provides support for ASM instances and specifically for disk groups. When connected to a datasource that has an ASM instance, new Instance > ASM and Instance > ASM > Disk Groups nodes are visible. 56 DBARTISAN XE 2/9.0 QUICK START GUIDE

57 NEW FEATURES After connecting to the datasource, on the first action against disk groups you are prompted for connection information and logon credentials to obtain a dedicated connection to the ASM instance. You can opt to use only the current datasource connection, in which case you can open an editor to view, but not modify, existing disk group definitions. With a dedicated connection to the ASM instance, you can create and modify disk groups using a new Disk Group Wizard and Disk Group Editor. You also have access to Check Disk Group, Mount Disk Group, Rebalance Disk Group, and Undrop Disk object operations. Manage ASM Connection and Disconnect ASM Connection operations let you toggle between the default datasource connection and the dedicated ASM instance connection. Other related updates include: Availability of the SYSASM privilege to provide full administrative privilege for the ASM instance Ability to register the ASM instance directly as a datasource using the Datasource Registration Wizard DBMS_STATS procedure call availability with Analyze object action The Analyze object action, available against clusters, indexes (primary keys, unique keys), and tables, now offers options corresponding to DBMS_STATS package procedure calls. The following table displays the new DBArtisan options available in the Analyze wizard and the corresponding DBMS_STATS procedure calls generated for those options.: DBArtisan Analyze wizard option Gather Statistics Delete Statistics Import Statistics DBMS_STATS call generated DBMS_STATS.GATHER_INDEX_STATS DBMS_STATS.GATHER_TABLE_STATS, DBMS_STATS.DELETE_INDEX_STATS DBMS_STATS.DELETE_TABLE_STATS DBMS_STATS.IMPORT_INDEX_STATS DBMS_STATS.IMPORT_TABLE_STATS Virtual Columns Against Oracle 11g datasources, DBArtisan now supports virtual columns. When defining a column in the Table Editor, you can use the new Virtual property to define a column as virtual. You then use the Default Value control to enter a valid Oracle column expression defining the virtual column. DBARTISAN XE 2/9.0 QUICK START GUIDE 57

58 NEW FEATURES Unusable Index Partition visibility Opened against a partitioned index, the Index Editor s Partition tab now displays whether Oracle has marked a partition definition as unusable. Temporary Tablespace Group Support The Tablespace Wizard now has a Tablespace Group control available when creating TEMPORARY tablespaces. Temporary tablespace group support provides the following benefits: Multiple default temporary tablespaces can be specified at the database level Users can make simultaneous use of multiple temporary tablespaces in different sessions Single SQL operations can make use of multiple temporary tablespaces for sorting. 58 DBARTISAN XE 2/9.0 QUICK START GUIDE

59 NEW FEATURES Invisible Indexes For Oracle 11g datasources, DBArtisan now supports invisible indexes. Both the Index Wizard and Index Editor have an Invisible property. This property lets you include an INVISIBLE clause with the CREATE INDEX statement in the DDL generated to create to edit the index. Invisible indexes are not used by the optimizer during queries unless the OPTIMIZER_USE_INVISIBLE_INDEXES parameter is set to TRUE at the session or system level. Read-only Table Support A new Change Access Status action lets you toggle a table between READ ONLY and READ/ WRITE modes. The Oracle Tables Editor and the Datasource Explorer display for an Oracle table have both been updated to indicate the current READ ONLY mode status. Online Reorganize Tables Option When executed against Oracle tables, the Reorganize object action now offers an Online option. During an online reorganization, the table can still be accessed using DML statements like SELECT and UPDATE. DBARTISAN XE 2/9.0 QUICK START GUIDE 59

60 NEW FEATURES Online reorganization is implemented using DBMS_REDEFINITION procedures. DBMS_REDEFINITION is Oracle s online table reorganization package and is available as of Oracle 9i. Recycle Bin Support This release introduces support for the Oracle Recycle Bin, letting you retain dropped tables and associated objects until they are explicitly purged. The Recycle Bin can be enabled and disabled at the datasource node level. Selecting the Schema > Recycle Bin node displays the current contents of the Recycle Bin. Object actions available against objects currently in the Recycle Bin offer a variety of purge, recover, and querying options. 60 DBARTISAN XE 2/9.0 QUICK START GUIDE

61 NEW FEATURES FLASHBACK TABLE Action Support A Flashback Table action now available against Oracle tables, lets you restore a table to some previous state. Options let you restore to a timestamp, an SCN, or a defined Restore Point. For tables in the Recycle Bin, you can restore the table to its state before being dropped. SYBASE FEATURE SUPPORT The following topics describe updated support for Sybase features. Login Trigger Support You can now configure a login to have a procedure executed each time a user logs in successfully. The Add/Modify Login Trigger object action lets you configure any stored procedure on the user s default database as a login trigger. The Drop Login Trigger object action lets you drop a configured login trigger from a login. When a login is configured with a login trigger, the stored procedure name is visible as a Login trigger property in the Logins Editor. DBARTISAN XE 2/9.0 QUICK START GUIDE 61

62 NEW FEATURES Support for sp_hidetext This release introduces support for the sp_hidetext system procedure. A new Hide Text object action lets you hide the source text for supported, compiled objects. INSTEAD OF Triggers The Trigger Wizard and Trigger Editor have been updated to support the INSTEAD OF form of CREATE TRIGGER statements. Now, when you select a Parent Type of View for a trigger, the wizard generates customizable INSTEAD OF trigger code syntax on the Definition tab. User-defined Functions This release provides support for Sybase user-defined functions. A new wizard and editor are provided. The wizard generates CREATE FUNCTION syntax, letting you provide the body of the function. A basic set of object operations is also provided. 62 DBARTISAN XE 2/9.0 QUICK START GUIDE

63 NEW FEATURES Data Cache Partitions Support The Data Cache Wizard now includes a Partitions property that lets you partition a cache. Selecting a legal value (1-64, in powers of 2) adds that sp_cacheconfig cache_partition parameter value to the DDL generated to create the data cache. DBARTISAN XE 2/9.0 QUICK START GUIDE 63

64 NEW FEATURES Data Cache Object Binding at Creation Time An Objects panel, previously only available on the Data Caches Editor, is now available on the Data Cache Wizard. It lets you manage the databases, tables, and indexes that are to be bound to the data cache being created. DB2 Z/OS FEATURE SUPPORT The following topics describe updated support for DB2 z/os features. Additional Status/Performance Information Three new subnodes are available under the Performance node. The Databases, Restricted Tablespaces, and Database Locks nodes display -DISPLAY DATABASE command status codes and related information on tablespaces, indexes, and locks. 64 DBARTISAN XE 2/9.0 QUICK START GUIDE

65 NEW FEATURES DATASOURCE/SERVER UPDATES JDBC Driver Availability When registering or editing datasources, third-party JDBC driver options are no longer available. Current Session Role Activation For Oracle and Sybase datasources, you can now activate and deactivate roles for the current login or user within the current session. The Role Activation feature lets you build and submit SET ROLE commands. UNICODE UPDATES Unicode character-handling has been improved in the SQL Editor and Data Editor. This includes: Improved encoding detection and options when saving and opening files Additional UTF-8, UTF-16, and UTF-32 encodings with BOM and endian variations are now available Handling of surrogate pairs and characters made up of multiple unicode (LTR scripts only) have been brought in line with Windows Vista and Windows 7 support. DBARTISAN XE 2/9.0 QUICK START GUIDE 65

66 NEW FEATURES SQL EDITOR Query Options Supporting Sybase Set Option Text Format Messages If you are using the sa_role or have the set tracing permission, you can now set the query environment to generate diagnostic output in text format. The Query Options dialog now offers all show option variations for the Set command. PERFORMANCE ANALYST UPDATES Availability of sp_sysmon noclear Option Against Sybase Datasources Previous releases did not surface control of the sp_sysmon noclear option. As a result, if another application was using the monitor, starting Performance Analyst could zero out monitor counters, potentially corrupting the results for the other application. This release introduces support for the noclear option, introduced for Sybase ASE and DBARTISAN XE 2/9.0 QUICK START GUIDE

67 NEW FEATURES You can set a default sp_sysmon noclear setting used whenever a Performance Analyst session is opened. You can also override the setting for the current session. USER INTERFACE CHANGES AND RELATED FEATURES Continuing from previous releases, this release features reworked object management editors and wizards. By DBMS platform: Oracle - Tablespaces SQL Server - Logins Sybase - Logins, Groups, User Messages, Dump Devices, Remote Servers, Roles DBARTISAN XE 2/9.0 QUICK START GUIDE 67