PUBLIC SAP HANA Database Explorer 2.0 SP 11 Document Version: 1.0 – 2019-09-12 SAP HANA Database Explorer company. All rights reserved. All rights company. affiliate THE BEST RUN 2019 SAP SE or an SAP SE or an SAP SAP 2019 © Content 1 Getting Started With the SAP HANA Database Explorer...............................4 1.1 What's New in SAP HANA Database Explorer......................................... 5 1.2 Open Catalog Objects..........................................................6 1.3 Create URL Shortcuts to Database Objects in the SAP HANA Database Explorer.................7 1.4 Search for Database Objects in the SAP HANA Database Explorer...........................7 1.5 Add SAP HANA Cockpit Resources and Databases to the SAP HANA Database Explorer...........9 1.6 Add HDI Containers and Databases to the SAP HANA Database Explorer.....................12 2 Security in the SAP HANA Database Explorer......................................16 2.1 Data Protection in SAP HANA Database Explorer......................................16 Delete Personal Data....................................................... 18 Delete Your Personal Data................................................... 20 2.2 Securing the SAP HANA Database Explorer..........................................21 Secure the SAP HANA Database Explorer from Web Socket Attacks......................22 3 Analyzing and Diagnosing Errors...............................................24 3.1 Configure Tracing in the SAP HANA Database Explorer..................................24 3.2 View Diagnostic Files in the SAP HANA Database Explorer...............................25 View Diagnosis Files of an Unavailable Tenant Database.............................. 26 3.3 Traces....................................................................27 Database Trace (Basic, User-Specific, and End-to-End)...............................29 SQL Trace...............................................................34 Performance Trace........................................................ 38 Expensive Statements Trace..................................................39 Kernel Profiler............................................................42 Traces and Trace Configuration for Internal Web Dispatcher............................44 3.4 Set Session Logging..........................................................46 3.5 View SQLScript Code Coverage Report.............................................46 3.6 View Database Procedures in the SAP HANA Database Explorer...........................47 Debug Procedures in the SAP HANA Database Explorer.............................. 48 3.7 SAP HANA Database Explorer Debugger Tutorials.....................................50 Tutorial: Connecting the Debugger..............................................51 Tutorial: Debugging a Procedure by Setting Breakpoints..............................52 Tutorial: Debugging a Function by Setting Breakpoints............................... 53 Tutorial: Debugging an Anonymous Block........................................ 54 Tutorial: Debugging a SQLScript Library..........................................55 Tutorial: Working With Expressions in the Debugger................................. 55 SAP HANA Database Explorer 2 PUBLIC Content Tutorial: Working with Variables in the Debugger....................................56 Tutorial: Working With Watchpoints in the Debugger.................................57 Tutorial: Quitting the Debugging Session.........................................58 4 Querying the Database.......................................................60 4.1 Execute SQL Statements.......................................................61 4.2 Execute Parameterized Statements...............................................63 4.3 Run a Query as a Background Activity..............................................63 4.4 Use the Statement Library to Administer Your Database ................................65 4.5 Work With Graph Workspaces in SAP HANA Database Explorer............................67 5 Analyzing Performance...................................................... 69 5.1 Analyzing Statement Performance................................................69 Analyze Statement Performance...............................................71 5.2 Analyzing SQL and Saving Plans..................................................75 Save Plans as Files.........................................................76 Download Files........................................................... 77 5.3 Analyze Procedure and Function Performance........................................78 5.4 View Execution Plans for SQL Statements, Procedures, and Anonymous Blocks................79 5.5 Viewing the Trace File List......................................................80 6 Importing, Exporting, and Accessing Data........................................ 81 6.1 Create a Remote Source....................................................... 81 Edit a Remote Source.......................................................83 6.2 Edit a Remote Source.........................................................84 6.3 Create Virtual Objects (Smart Data Access)......................................... 85 6.4 Create Virtual Objects (SAP HANA Smart Data Integration)..............................86 6.5 Import Schemas, Tables, and Other Catalog Objects................................... 87 6.6 Import Data Into a New or Existing Table............................................88 6.7 Import HDI Containers........................................................90 6.8 Export Schemas, Tables, and Other Catalog Objects ................................... 91 6.9 Export HDI Containers........................................................ 93 7 Important Disclaimer for Features in SAP HANA................................... 95 SAP HANA Database Explorer Content PUBLIC 3 1 Getting Started With the SAP HANA Database Explorer Use the SAP HANA database explorer to query information about the database, as well as view information about your database's catalog objects. The database explorer is integrated into both the SAP Web IDE for SAP HANA and in the SAP HANA cockpit. The database explorer contains features and functions required by both database administrators and developers. What can I do with the SAP HANA database explorer? The SAP HANA database explorer allows you to query your database and view information about your catalog objects, by providing the following functionality: A catalog browser View the definitions of all types of catalog objects, for example: tables, views, stored procedures, functions, and synonyms. Also, view the content (data) of your tables and views. An SQL console Create SQLScript procedures and queries, and then execute them or analyze their performance using the SQL analyzer. An SQL analyzer View detailed information on your queries and evaluate potential bottlenecks and optimizations for these queries. The SQL analyzer is accessible from the SQL console, as well as from the plan trace and expensive statement features in the SAP HANA cockpit. An SQL debugger View the call stack, set break points, view and evaluate expressions and variables. Related Information SAP Note 2373065 SAP HANA Database Explorer 4 PUBLIC Getting Started With the SAP HANA Database Explorer 1.1 What's New in SAP HANA Database Explorer The following features are new or changed for this release of SAP HANA database explorer. Debugger You can now edit the values of the following global and local variable types: (Enhancement) ● BINARY, VARBINARY ● BOOLEAN ● STRING ● CHAR, NCHAR, VARCHAR, NVARCHAR, VARCHAR3, VARCHAR2 ● DATE, TIME, TIMESTAMP, DAYDATE, SECONDTIME, LONGDATE, SECONDDATE ● INTEGER, INT, TINYINT, SMALLINT, BIGINT ● DECIMAL, SMALLDECIMAL ● REAL, DOUBLE, FLOAT Database Overview Right-click a database in your catalog browser and click Show Overview to view (New) general information about your database such as, the system usage type, the most recently started service, and the version. In SAP Web IDE, the Overview tab is not available for HDI containers. Persisting Result Sets The following new SQL Console Preferences have been added: (New) ● Set the maximum number of open results; the default is 50. ● Set whether to close results before executing another SQL statement. Trace Analysis (New) Use the new Trace Analysis feature to see all the traced files in your system and to get information on them. Display of JSON, Previously in the Data Preview table or the SQL console results table, JSON, HTML, HTML, and XML Data or XML data was only viewable as raw text. Now, you can right-click cell contents that (Enhancement) are JSON, HTML, or XML and click View Data to view the data in its proper JSON, HTML, or XML format. Table Editor The table editor contains the following enhancements: (Enhancement) ● A new Properties tab that displays all the table's properties. ● Any information added in the table's COMMENTS property appear in the header of the table editor. Add Database Dialog If you have more than 500 HDI containers, then you can filter your search for the HDI (Enhancement) container that you want to add to database explorer by Organization and Space. SAP HANA Database Explorer Getting Started With the SAP HANA Database Explorer PUBLIC 5 1.2 Open Catalog Objects Browse your database's catalog using the SAP HANA database explorer. Prerequisites You must be a user of the database that you want to explore and you must have the required privileges to view the catalog items. Context