PUBLIC SAP HANA Database Explorer 2.0 SP 12 Document Version: 1.0 – 2020-05-14 SAP HANA Database Explorer company. All rights reserved. All rights company. affiliate THE BEST RUN 2020 SAP SE or an SAP SE or an SAP SAP 2020 © 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..........................................................8 1.3 Create URL Shortcuts to Database Objects in the SAP HANA Database Explorer................ 9 1.4 Search for Database Objects in the SAP HANA Database Explorer...........................9 1.5 Add a Database to the SAP HANA Database Explorer...................................10 1.6 Add HDI Containers and Databases to the SAP HANA Database Explorer.....................13 2 Security in the SAP HANA Database Explorer......................................17 2.1 Data Protection in SAP HANA Database Explorer......................................17 Delete Personal Data....................................................... 19 Delete Your Personal Data....................................................21 2.2 Securing the SAP HANA Database Explorer..........................................22 Secure the SAP HANA Database Explorer from Web Socket Attacks......................23 3 Analyzing and Diagnosing Errors............................................... 25 3.1 Set Session Logging..........................................................25 3.2 View SQLScript Code Coverage Report.............................................26 3.3 View Database Procedures in the SAP HANA Database Explorer...........................27 Debug Procedures in the SAP HANA Database Explorer...............................27 3.4 SAP HANA Database Explorer Debugger Tutorials.....................................29 Tutorial: Connecting the Debugger............................................. 30 Tutorial: Debugging a Procedure by Setting Breakpoints...............................31 Tutorial: Debugging a Function by Setting Breakpoints............................... 32 Tutorial: Debugging an Anonymous Block........................................ 33 Tutorial: Debugging a SQLScript Library..........................................34 Tutorial: Working With Expressions in the Debugger................................. 34 Tutorial: Working with Variables in the Debugger....................................35 Tutorial: Working With Watchpoints in the Debugger.................................36 Tutorial: Quitting the Debugging Session......................................... 37 4 Querying the Database.......................................................39 4.1 Execute SQL Statements.......................................................40 4.2 Execute Parameterized Statements...............................................42 4.3 Run a Query as a Background Activity..............................................43 4.4 Use the Statement Library to Administer Your Database ................................44 4.5 Work With Graph Workspaces in SAP HANA Database Explorer............................46 SAP HANA Database Explorer 2 PUBLIC Content 5 Analyzing Performance...................................................... 48 5.1 Configure Tracing in the SAP HANA Database Explorer..................................48 5.2 View Diagnostic Files in the SAP HANA Database Explorer...............................49 Viewing the Trace File List....................................................50 View Diagnosis Files of an Unavailable Tenant Database.............................. 50 5.3 Traces....................................................................51 Database Trace (Basic, User-Specific, and End-to-End)...............................53 SQL Trace...............................................................58 Performance Trace........................................................ 62 Expensive Statements Trace..................................................63 Kernel Profiler............................................................66 Traces and Trace Configuration for Internal Web Dispatcher............................68 5.4 Analyzing Statement Performance................................................70 Analyze Statement Performance...............................................72 5.5 Analyzing SQL and Saving Plans..................................................76 Save Plans as Files.........................................................76 Download Files........................................................... 78 5.6 Analyze Procedure and Function Performance........................................79 5.7 View Execution Plans for SQL Statements, Procedures, and Anonymous Blocks................80 6 View Diagnostic Files in the SAP HANA Database Explorer............................81 6.1 Viewing the Trace File List......................................................82 6.2 View Diagnosis Files of an Unavailable Tenant Database.................................82 7 Importing, Exporting, and Accessing Data........................................84 7.1 Create a Remote Source.......................................................84 Edit a Remote Source.......................................................86 7.2 Edit a Remote Source.........................................................87 7.3 Create Virtual Objects (Smart Data Access)......................................... 88 7.4 Create Virtual Objects (SAP HANA Smart Data Integration)..............................89 7.5 Import Schemas, Tables, and Other Catalog Objects...................................90 7.6 Import Data Into a New or Existing Table............................................91 7.7 Import HDI Containers........................................................ 93 7.8 Export Schemas, Tables, and Other Catalog Objects ...................................94 7.9 Export HDI Containers........................................................ 96 8 Important Disclaimer for Features in SAP HANA................................... 98 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. Change a Database You can now change the name that is displayed for your database in the catalog Name (New) browser tree. Right-click your database and click Properties, then edit the Name to Show in Display field. Add a Database When adding a cockpit database to the database explorer, you can now choose to enter a With a Different User and Password that is different than that provided in the cockpit for that database. User (New) Moreover, once you've added a database to the database explorer, you can go back later and re-add it with different user credentials by right-clicking the database and clicking Add Database with Different User. See Add a Database to the SAP HANA Database Explorer [page 10] SQL Console ● The SQL Console page of the Global Preferences contains the following new options: (Enhancements) On error Allows you to control the behavior of the SQL console when it encounters a SQL error. You can choose the following actions: Stop, Continue, or Prompt. Command If your SQL statements contain a custom command separator, then Separator set the custom separator in the SQL Console section of the Global Preferences so that the parser recognizes your command separator. Command separators differ from statement delimiters in that they separate commands, which can be either a single-line SQL statement or a block of SQL statements that are separated by their own statement delimiter. ● A new History tab has been added to the SQL console. This tab shows the 50 most recently executed statements. For more information, see Querying the Database [page 39]. ● Statement Use the new SQL console side panel to access syntax for SQL Help (New) statements and to view metadata SQL objects. You can view the following information: Statement/ View the syntax of the statement you are Syntax currently editing and use the