Update metadata

Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>

docs/dws/api-ref/dws_02_0030.html

@@ -120,7 +120,7 @@
 </td>
 <td class="cellrowborder" valign="top" width="21.92%" headers="mcps1.3.2.2.6.1.3 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_en-us_topic_0067711912_p24250547">Invalid password of database <strong id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_en-us_topic_0000001081890905_en-us_topic_0067711912_b84235270616262">root</strong>.</p>
 </td>
-<td class="cellrowborder" valign="top" width="23.369999999999997%" headers="mcps1.3.2.2.6.1.4 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p7792135191117">Invalid password of database <strong id="EN-US_TOPIC_0000001326816266__b350624923">root</strong>.</p>
+<td class="cellrowborder" valign="top" width="23.369999999999997%" headers="mcps1.3.2.2.6.1.4 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p7792135191117">Invalid password of database <strong id="EN-US_TOPIC_0000001326816266__b1727966551">root</strong>.</p>
 </td>
 <td class="cellrowborder" valign="top" width="34.97%" headers="mcps1.3.2.2.6.1.5 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p0284735122">Enter a valid password according to the password description.</p>
 </td>
@@ -791,7 +791,7 @@
 </td>
 <td class="cellrowborder" valign="top" width="21.92%" headers="mcps1.3.2.2.6.1.3 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p12781010183114">The ECS group parameter is missing.</p>
 </td>
-<td class="cellrowborder" valign="top" width="23.369999999999997%" headers="mcps1.3.2.2.6.1.4 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p1178111093112">The ECS group parameters is missing.</p>
+<td class="cellrowborder" valign="top" width="23.369999999999997%" headers="mcps1.3.2.2.6.1.4 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p1178111093112">The ECS group parameters are missing.</p>
 </td>
 <td class="cellrowborder" valign="top" width="34.97%" headers="mcps1.3.2.2.6.1.5 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p378111017316">Enter a valid parameter and try again.</p>
 </td>
@@ -868,7 +868,7 @@
 </td>
 <td class="cellrowborder" valign="top" width="21.92%" headers="mcps1.3.2.2.6.1.3 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p881912518332">Invalid <strong id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_en-us_topic_0000001081890905_b1578913326147">fill_missing_fields</strong> parameter in the data file. The supported values are <strong id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_en-us_topic_0000001081890905_b813262141">true/on</strong> and <strong id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_en-us_topic_0000001081890905_b111365299144">false/off</strong>.</p>
 </td>
-<td class="cellrowborder" valign="top" width="23.369999999999997%" headers="mcps1.3.2.2.6.1.4 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p56001842182018">Invalid <strong id="EN-US_TOPIC_0000001326816266__b2068244356">fill_missing_fields</strong> parameter in the data file. The supported values are <strong id="EN-US_TOPIC_0000001326816266__b1811642260">true/on</strong> and <strong id="EN-US_TOPIC_0000001326816266__b432604932">false/off</strong>.</p>
+<td class="cellrowborder" valign="top" width="23.369999999999997%" headers="mcps1.3.2.2.6.1.4 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p56001842182018">Invalid <strong id="EN-US_TOPIC_0000001326816266__b1271484957">fill_missing_fields</strong> parameter in the data file. The supported values are <strong id="EN-US_TOPIC_0000001326816266__b644141330">true/on</strong> and <strong id="EN-US_TOPIC_0000001326816266__b462672009">false/off</strong>.</p>
 </td>
 <td class="cellrowborder" valign="top" width="34.97%" headers="mcps1.3.2.2.6.1.5 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p581995163311">Enter the correct <strong id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_en-us_topic_0000001081890905_b1591810414144">fill_missing_fields</strong> parameter and try again later.</p>
 </td>
@@ -879,7 +879,7 @@
 </td>
 <td class="cellrowborder" valign="top" width="21.92%" headers="mcps1.3.2.2.6.1.3 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p43121832123319">Invalid <strong id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_en-us_topic_0000001081890905_b1428720535142">ignore_extra_data</strong> parameter in the data file. The supported values are <strong id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_en-us_topic_0000001081890905_b96689594144">true/on</strong> and <strong id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_en-us_topic_0000001081890905_b2176184121514">false/off</strong>.</p>
 </td>
-<td class="cellrowborder" valign="top" width="23.369999999999997%" headers="mcps1.3.2.2.6.1.4 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p11600144213203">Invalid <strong id="EN-US_TOPIC_0000001326816266__b1256914337">ignore_extra_data</strong> parameter in the data file. The supported values are <strong id="EN-US_TOPIC_0000001326816266__b1912214801">true/on</strong> and <strong id="EN-US_TOPIC_0000001326816266__b373521267">false/off</strong>.</p>
+<td class="cellrowborder" valign="top" width="23.369999999999997%" headers="mcps1.3.2.2.6.1.4 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p11600144213203">Invalid <strong id="EN-US_TOPIC_0000001326816266__b1844319300">ignore_extra_data</strong> parameter in the data file. The supported values are <strong id="EN-US_TOPIC_0000001326816266__b69198589">true/on</strong> and <strong id="EN-US_TOPIC_0000001326816266__b579966380">false/off</strong>.</p>
 </td>
 <td class="cellrowborder" valign="top" width="34.97%" headers="mcps1.3.2.2.6.1.5 "><p id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_p7312432123312">Enter the correct <strong id="EN-US_TOPIC_0000001326816266__en-us_topic_0000001134564656_en-us_topic_0000001081890905_b8620513111510">ignore_extra_data</strong> parameter and try again later.</p>
 </td>

docs/dws/api-ref/dws_02_0031.html

@@ -8,9 +8,14 @@
 </th>
 </tr>
 </thead>
-<tbody><tr id="EN-US_TOPIC_0000001185673176__row10631910499"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0000001185673176__p363261013913">2024-09-30</p>
+<tbody><tr id="EN-US_TOPIC_0000001185673176__row1513081911417"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0000001185673176__p9130101916417">2025-04-03</p>
 </td>
-<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.1.1.3.1.2 "><p id="EN-US_TOPIC_0000001185673176__p1763312109919">This issue is the eighteenth official release for the 8.2.1.220 cluster.</p>
+<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.1.1.3.1.2 "><p id="EN-US_TOPIC_0000001185673176__p12960631649">This issue is the nineteenth official release for cluster version 9.1.0.211.</p>
+</td>
+</tr>
+<tr id="EN-US_TOPIC_0000001185673176__row571216682"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0000001185673176__p117131161784">2024-09-30</p>
+</td>
+<td class="cellrowborder" valign="top" width="77%" headers="mcps1.3.1.1.3.1.2 "><p id="EN-US_TOPIC_0000001185673176__p1371312612810">This issue is the eighteenth official release for the 8.2.1.220 cluster.</p>
 </td>
 </tr>
 <tr id="EN-US_TOPIC_0000001185673176__row14619134212409"><td class="cellrowborder" valign="top" width="23%" headers="mcps1.3.1.1.3.1.1 "><p id="EN-US_TOPIC_0000001185673176__p19891853184020">2024-03-29</p>

docs/dws/api-ref/dws_02_0033.html

@@ -1,13 +0,0 @@
-<a name="EN-US_TOPIC_0000001185673168"></a><a name="EN-US_TOPIC_0000001185673168"></a>
-
-<h1 class="topictitle1">Overview</h1>
-<div id="body1558595678679"><p id="EN-US_TOPIC_0000001185673168__p19736105151614">Welcome to GaussDB(DWS). GaussDB(DWS) is a fully-managed and enterprise-level cloud data warehouse service. It is O&amp;M-free, compatible with the PostgreSQL ecosystem, and supports online cluster scale-out and efficient loading of multiple data sources. GaussDB(DWS) helps enterprises efficiently analyze and monetize massive data online.</p>
-<p id="EN-US_TOPIC_0000001185673168__p1114017589475">This document describes how to use application programming interfaces (APIs) to create, query, and delete GaussDB(DWS) clusters, tags, and snapshots. For details about all supported operations, see <a href="dws_02_0034.html">API Overview</a>.</p>
-<p id="EN-US_TOPIC_0000001185673168__p1453514534137">Before calling an API, get familiar with related concepts of GaussDB(DWS). For details, see "Service Overview" in the <em id="EN-US_TOPIC_0000001185673168__i1340473463118">Data Warehouse Service User Guide</em>.</p>
-</div>
-<div>
-<div class="familylinks">
-<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_02_0057.html">Before You Start</a></div>
-</div>
-</div>
-

docs/dws/api-ref/dws_02_0034.html

@@ -116,4 +116,5 @@
 </table>
 </div>
 </div>
+<div></div>
 

docs/dws/api-ref/dws_02_0056.html

@@ -6,8 +6,8 @@
 <p id="EN-US_TOPIC_0000001185673170__p45185296531">You can grant users permissions by using roles and policies. Roles are provided by IAM to define service-based permissions depending on users' job responsibilities. Policies define API-based permissions for operations on specific resources under certain conditions, allowing for more fine-grained, secure access control of cloud resources.</p>
 <div class="note" id="EN-US_TOPIC_0000001185673170__note134381729185315"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001185673170__p6654112423110">Policy-based authorization is useful if you want to allow or deny the access to an API.</p>
 </div></div>
-<p id="EN-US_TOPIC_0000001185673170__p279171816357">An account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned. The permissions required for calling an API are determined by the actions supported by the API. Only users who have been granted permissions allowing the actions can call the API successfully. For example, if an IAM user wants to query the GaussDB(DWS) cluster list using an API, the user must have been granted permissions that allow the <strong id="EN-US_TOPIC_0000001185673170__b1447294791413">dws:openAPICluster:list</strong> action.</p>
-<div class="section" id="EN-US_TOPIC_0000001185673170__section66645189352"><h4 class="sectiontitle">Supported Actions</h4><p id="EN-US_TOPIC_0000001185673170__p284917302096">DWS provides system-defined policies that can be directly used in IAM. You can also create custom policies and use them to supplement system-defined policies, implementing more refined access control. Actions supported by policies are specific to APIs. The following are common concepts related to policies:</p>
+<p id="EN-US_TOPIC_0000001185673170__p279171816357">An account has full permissions to access all APIs, but each IAM user needs to be granted the necessary permissions before they can begin using the APIs. The permissions required for calling an API are determined by the actions supported by the API. Only users who have been granted permissions allowing the actions can call the API successfully. For example, if an IAM user wants to query the GaussDB(DWS) cluster list using an API, the user must have been granted permissions that allow the <strong id="EN-US_TOPIC_0000001185673170__b1447294791413">dws:openAPICluster:list</strong> action.</p>
+<div class="section" id="EN-US_TOPIC_0000001185673170__section66645189352"><h4 class="sectiontitle">Supported Actions</h4><p id="EN-US_TOPIC_0000001185673170__p284917302096">GaussDB(DWS) provides system-defined policies that can be directly used in IAM. Database administrators can also create custom policies and use them to supplement system-defined policies, implementing more refined access control. Actions supported by policies are specific to APIs. The following are common concepts related to policies:</p>
 <ul id="EN-US_TOPIC_0000001185673170__ul6791818113512"><li id="EN-US_TOPIC_0000001185673170__li479191814351"><strong id="EN-US_TOPIC_0000001185673170__b9309172111227">Permissions</strong>: Allow or deny operations on specified resources under specific conditions.</li><li id="EN-US_TOPIC_0000001185673170__li13468347313"><strong id="EN-US_TOPIC_0000001185673170__b166193141210">APIs</strong>: RESTful APIs that can be called in a custom policy.</li><li id="EN-US_TOPIC_0000001185673170__li87911018113515"><strong id="EN-US_TOPIC_0000001185673170__b5671173217227">Actions</strong>: Added to a custom policy to control permissions for specific operations.</li><li id="EN-US_TOPIC_0000001185673170__li47911918153513"><strong id="EN-US_TOPIC_0000001185673170__b1875325320129">IAM or enterprise projects</strong>: Type of projects for which an action will take effect. Policies that contain actions supporting both IAM and enterprise projects can be assigned to user groups and take effect in both IAM and Enterprise Management. Policies that only contain actions supporting IAM projects can be assigned to user groups and only take effect for IAM. Such policies will not take effect if they are assigned to user groups in Enterprise Management. <div class="note" id="EN-US_TOPIC_0000001185673170__note396918413431"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001185673170__p1440311715430">The check mark (√) indicates that an action takes effect. The cross mark (x) indicates that an action does not take effect.</p>
 </div></div>
 </li></ul>

docs/dws/api-ref/dws_02_0057.html

@@ -1,17 +1,29 @@
 <a name="EN-US_TOPIC_0000001231391265"></a><a name="EN-US_TOPIC_0000001231391265"></a>
 
 <h1 class="topictitle1">Before You Start</h1>
-<div id="body8662426"></div>
-<div>
-<ul class="ullinks">
-<li class="ulchildlink"><strong><a href="dws_02_0033.html">Overview</a></strong><br>
-</li>
-<li class="ulchildlink"><strong><a href="dws_02_0058.html">API Calling</a></strong><br>
-</li>
-<li class="ulchildlink"><strong><a href="dws_02_0059.html">Endpoints</a></strong><br>
-</li>
-<li class="ulchildlink"><strong><a href="dws_02_0061.html">Basic Concepts</a></strong><br>
-</li>
-</ul>
+<div id="body8662426"><div class="section" id="EN-US_TOPIC_0000001231391265__section13064913205"><h4 class="sectiontitle">Overview</h4><p id="EN-US_TOPIC_0000001231391265__p19736105151614">Welcome to GaussDB(DWS). GaussDB(DWS) is a fully-managed and enterprise-level cloud data warehouse service. It is O&amp;M-free, compatible with the PostgreSQL ecosystem, and supports online cluster scale-out and efficient loading of multiple data sources. It helps enterprises efficiently analyze and monetize massive amounts of data online.</p>
+<p id="EN-US_TOPIC_0000001231391265__p1114017589475">This guide explains how to use APIs to manage GaussDB(DWS) clusters, including creating, querying, and deleting tags and snapshots. For details about all supported operations, see <a href="dws_02_0034.html">API Overview</a>.</p>
+<p id="EN-US_TOPIC_0000001231391265__p1453514534137">Before calling an API, get familiar with related concepts of GaussDB(DWS). For details, see "Service Overview" in the <em id="EN-US_TOPIC_0000001231391265__i6126135912314">Data Warehouse Service User Guide</em>.</p>
+<p id="EN-US_TOPIC_0000001231391265__p015144811238">GaussDB(DWS) supports Representational State Transfer (REST) APIs, allowing you to call APIs using HTTPS. For details about API calling, see <a href="dws_02_0062.html">Calling APIs</a>.</p>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001231391265__section102945256216"><h4 class="sectiontitle">Endpoints</h4><p id="EN-US_TOPIC_0000001231391265__p2012412713342">An endpoint is the <strong id="EN-US_TOPIC_0000001231391265__b1047015531339">request address</strong> for calling an API. Endpoints vary depending on services and regions. For the endpoints of all services, see "Regions and Endpoints".</p>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001231391265__section129413815217"><h4 class="sectiontitle">Basic Concepts</h4><ul id="EN-US_TOPIC_0000001231391265__uad440ee9aedc458c9e5803cdcaf583f3"><li id="EN-US_TOPIC_0000001231391265__l53265badde5b43c3a22e01066a8c0895">Account<p id="EN-US_TOPIC_0000001231391265__a848efff567cd45e3a0ef2ba8583a3b30"><a name="EN-US_TOPIC_0000001231391265__l53265badde5b43c3a22e01066a8c0895"></a><a name="l53265badde5b43c3a22e01066a8c0895"></a>An account has full access permissions for all the resources and cloud services under it. It can reset user passwords and grant users permissions. For security purposes, create IAM users and assign them permissions for routine management.</p>
+</li><li id="EN-US_TOPIC_0000001231391265__l543c20abbea64c6aa90c93a218b0649f">User<p id="EN-US_TOPIC_0000001231391265__af28cde395a474665a7bee2209ec76348"><a name="EN-US_TOPIC_0000001231391265__l543c20abbea64c6aa90c93a218b0649f"></a><a name="l543c20abbea64c6aa90c93a218b0649f"></a>An IAM user is created by an account to use cloud services. Each IAM user has its own identity credentials (password or access keys).</p>
+<p id="EN-US_TOPIC_0000001231391265__a06eea39f09294213ad2238a3afa823b4">The account name, username, and password will be required for API authentication.</p>
+</li><li id="EN-US_TOPIC_0000001231391265__l1df7515fe146487087a6c56e04cce7d2">Region<p id="EN-US_TOPIC_0000001231391265__a1ce56948b7974e819b1c77db09ee7cb7"><a name="EN-US_TOPIC_0000001231391265__l1df7515fe146487087a6c56e04cce7d2"></a><a name="l1df7515fe146487087a6c56e04cce7d2"></a>A region is a geographic area where cloud resources are deployed. Availability zones (AZs) in the same region can communicate with each other over an intranet, while AZs in different regions are isolated from each other. By creating cloud resources in different regions, you can better meet customer requirements and comply with local laws and regulations.</p>
+</li><li id="EN-US_TOPIC_0000001231391265__l0f82f0ff77dd424b99eecb8dcfbb9034">AZ<p id="EN-US_TOPIC_0000001231391265__acddbf6d1a8cc47f3981dcde005f38564"><a name="EN-US_TOPIC_0000001231391265__l0f82f0ff77dd424b99eecb8dcfbb9034"></a><a name="l0f82f0ff77dd424b99eecb8dcfbb9034"></a>An AZ contains one or more physical data centers. Each AZ has independent power and network devices. Within an AZ, computing, network, storage, and other resources are logically divided into multiple clusters. AZs within a region are interconnected using high-speed optical fibers to support cross-AZ high-availability systems.</p>
+</li><li id="EN-US_TOPIC_0000001231391265__l4e8b34eb5dad457b941ea6acff92b4ce">Project<p id="EN-US_TOPIC_0000001231391265__ab7f9f66fe89340a4b258cfd634fb12d3"><a name="EN-US_TOPIC_0000001231391265__l4e8b34eb5dad457b941ea6acff92b4ce"></a><a name="l4e8b34eb5dad457b941ea6acff92b4ce"></a>A project corresponds to a region. Default projects are defined to group and physically isolate resources (including compute, storage, and network resources) between different regions. Users can be granted permissions in a default project to access all resources under their accounts in the region associated with the project. For more refined access control, create subprojects under a project and apply for resources in the subprojects. Users can then be assigned permissions to access only specific resources in the subprojects.</p>
+<div class="fignone" id="EN-US_TOPIC_0000001231391265__fa00898fa7f3c46acb8c9cb021ff58a17"><span class="figcap"><b>Figure 1 </b>Project isolating model</span><br><span><img id="EN-US_TOPIC_0000001231391265__i7ac3726ed3ca4e4f9f5181684380e728" src="figure/en-us_image_0000002138022226.png" width="492.1" height="192.64770700000003" title="Click to enlarge" class="imgResize"></span></div>
+</li><li id="EN-US_TOPIC_0000001231391265__li206271015325">Enterprise project<p id="EN-US_TOPIC_0000001231391265__p3627315224"><a name="EN-US_TOPIC_0000001231391265__li206271015325"></a><a name="li206271015325"></a>Enterprise projects group and logically isolate resources. An enterprise project can contain resources from different regions, and resources can be transferred between enterprise projects.</p>
+</li></ul>
+</div>
 </div>
 
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/dws/api-ref/dws_02_0058.html

@@ -1,11 +0,0 @@
-<a name="EN-US_TOPIC_0000001231391261"></a><a name="EN-US_TOPIC_0000001231391261"></a>
-
-<h1 class="topictitle1">API Calling</h1>
-<div id="body1558595678679"><p id="EN-US_TOPIC_0000001231391261__p14901414121920">GaussDB(DWS) supports representational state transfer (REST) APIs, allowing you to call APIs using HTTPS. For details, see <a href="dws_02_0062.html">Calling APIs</a>.</p>
-</div>
-<div>
-<div class="familylinks">
-<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_02_0057.html">Before You Start</a></div>
-</div>
-</div>
-

docs/dws/api-ref/dws_02_0059.html

@@ -1,11 +0,0 @@
-<a name="EN-US_TOPIC_0000001186151622"></a><a name="EN-US_TOPIC_0000001186151622"></a>
-
-<h1 class="topictitle1">Endpoints</h1>
-<div id="body8662426"><p id="EN-US_TOPIC_0000001186151622__p2012412713342">An endpoint is the <strong id="EN-US_TOPIC_0000001186151622__b282913474311">request address</strong> for calling an API. Endpoints vary depending on services and regions. For the endpoints of all services, see the <strong id="EN-US_TOPIC_0000001186151622__b149545272229">Regions and Endpoints</strong> section.</p>
-</div>
-<div>
-<div class="familylinks">
-<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_02_0057.html">Before You Start</a></div>
-</div>
-</div>
-

docs/dws/api-ref/dws_02_0061.html

@@ -1,26 +0,0 @@
-<a name="EN-US_TOPIC_0000001231472769"></a><a name="EN-US_TOPIC_0000001231472769"></a>
-
-<h1 class="topictitle1">Basic Concepts</h1>
-<div id="body8662426"><ul id="EN-US_TOPIC_0000001231472769__uad440ee9aedc458c9e5803cdcaf583f3"><li id="EN-US_TOPIC_0000001231472769__l53265badde5b43c3a22e01066a8c0895">Account<p id="EN-US_TOPIC_0000001231472769__a848efff567cd45e3a0ef2ba8583a3b30"><a name="EN-US_TOPIC_0000001231472769__l53265badde5b43c3a22e01066a8c0895"></a><a name="l53265badde5b43c3a22e01066a8c0895"></a>This account has full access to all cloud services and resources associated with it. It can be used to reset user passwords and grant user permissions. The domain should not be used directly to perform routine management. For security purposes, create users and grant them permissions for routine management.</p>
-</li><li id="EN-US_TOPIC_0000001231472769__l543c20abbea64c6aa90c93a218b0649f">Users<p id="EN-US_TOPIC_0000001231472769__af28cde395a474665a7bee2209ec76348"><a name="EN-US_TOPIC_0000001231472769__l543c20abbea64c6aa90c93a218b0649f"></a><a name="l543c20abbea64c6aa90c93a218b0649f"></a>An IAM user is created using an account for cloud services. Each IAM user has its own identity credentials (password and access keys).</p>
-<p id="EN-US_TOPIC_0000001231472769__a06eea39f09294213ad2238a3afa823b4">The account name, username, and password are required for API authentication.</p>
-</li><li id="EN-US_TOPIC_0000001231472769__l1df7515fe146487087a6c56e04cce7d2">Region<p id="EN-US_TOPIC_0000001231472769__a1ce56948b7974e819b1c77db09ee7cb7"><a name="EN-US_TOPIC_0000001231472769__l1df7515fe146487087a6c56e04cce7d2"></a><a name="l1df7515fe146487087a6c56e04cce7d2"></a>A region is a geographic area in which cloud resources are deployed. Availability zones (AZs) in the same region can communicate with each other over an intranet, while AZs in different regions are isolated from each other. Deploying cloud resources in different regions can better suit certain user requirements or comply with local laws or regulations.</p>
-</li><li id="EN-US_TOPIC_0000001231472769__l0f82f0ff77dd424b99eecb8dcfbb9034">AZ<p id="EN-US_TOPIC_0000001231472769__acddbf6d1a8cc47f3981dcde005f38564"><a name="EN-US_TOPIC_0000001231472769__l0f82f0ff77dd424b99eecb8dcfbb9034"></a><a name="l0f82f0ff77dd424b99eecb8dcfbb9034"></a>An AZ contains one or more physical data centers. Each AZ has independent power and network devices. Within an AZ, computing, network, storage, and other resources are logically divided into multiple clusters. AZs within a region are interconnected using high-speed optical fibers to support cross-AZ high-availability systems.</p>
-</li><li id="EN-US_TOPIC_0000001231472769__l4e8b34eb5dad457b941ea6acff92b4ce">Item<p id="EN-US_TOPIC_0000001231472769__ab7f9f66fe89340a4b258cfd634fb12d3"><a name="EN-US_TOPIC_0000001231472769__l4e8b34eb5dad457b941ea6acff92b4ce"></a><a name="l4e8b34eb5dad457b941ea6acff92b4ce"></a>Projects group and isolate resources (including compute, storage, and network resources) across physical regions. A default project is provided for each service region, and subprojects can be created under each default project. Users can be granted permissions to access all resources in a specific project. For more refined access control, create subprojects under a project and apply for resources in the subprojects. IAM users can then be assigned permissions to access only specific resources in the subprojects.</p>
-<div class="fignone" id="EN-US_TOPIC_0000001231472769__fa00898fa7f3c46acb8c9cb021ff58a17"><span class="figcap"><b>Figure 1 </b>Project isolating model</span><br><span><img id="EN-US_TOPIC_0000001231472769__i7ac3726ed3ca4e4f9f5181684380e728" src="figure/en-us_image_0000001231391281.png" width="492.1" height="192.64770700000003" title="Click to enlarge" class="imgResize"></span></div>
-</li><li id="EN-US_TOPIC_0000001231472769__li206271015325">Enterprise project<p id="EN-US_TOPIC_0000001231472769__p3627315224"><a name="EN-US_TOPIC_0000001231472769__li206271015325"></a><a name="li206271015325"></a>Enterprise projects group and manage resources across regions. Resources in enterprise projects are logically isolated from each other. An enterprise project can contain resources of multiple regions, and resources can be added to or removed from enterprise projects.</p>
-</li></ul>
-</div>
-<div>
-<div class="familylinks">
-<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_02_0057.html">Before You Start</a></div>
-</div>
-</div>
-
-
-<script language="JavaScript">
-<!--
-image_size('.imgResize');
-var msg_imageMax = "view original image";
-var msg_imageClose = "close";
-//--></script>

docs/dws/api-ref/dws_02_0063.html

@@ -19,7 +19,7 @@
 </tr>
 <tr id="EN-US_TOPIC_0000001185673174__r8b17dfd690b64ff09a322e290bc49929"><td class="cellrowborder" valign="top" width="24.23%" headers="mcps1.3.2.5.2.3.1.1 "><p id="EN-US_TOPIC_0000001185673174__a192d0d49499b42dea9fcb9823bdcd208">Endpoint</p>
 </td>
-<td class="cellrowborder" valign="top" width="75.77000000000001%" headers="mcps1.3.2.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001185673174__p14221174382419">Domain name or IP address of the server bearing the REST service. The endpoint varies between services in different regions. It can be obtained from the "Regions and Endpoints" section.</p>
+<td class="cellrowborder" valign="top" width="75.77000000000001%" headers="mcps1.3.2.5.2.3.1.2 "><p id="EN-US_TOPIC_0000001185673174__p14221174382419">Domain name or IP address of the server bearing the REST service endpoint. The endpoint varies between services in different regions. It can be obtained from the "Regions and Endpoints" section.</p>
 <p id="EN-US_TOPIC_0000001185673174__p15129619134716">For example, the endpoint of IAM in the <span class="parmname" id="EN-US_TOPIC_0000001185673174__parmname51291019104710"><b>eu-de</b></span> region is <span class="parmname" id="EN-US_TOPIC_0000001185673174__parmname144291017134818"><b>iam.eu-de.otc.t-systems.com</b></span>.</p>
 </td>
 </tr>
@@ -170,13 +170,13 @@
 </table>
 </div>
 </div>
-<p id="EN-US_TOPIC_0000001185673174__a7ce99c8135d542989f3542afb96dd667">The API used to obtain a user token does not require authentication. Therefore, only the <strong id="EN-US_TOPIC_0000001185673174__b82371683910">Content-type</strong> field needs to be added to requests for calling the API. An example of such requests is as follows:</p>
+<p id="EN-US_TOPIC_0000001185673174__a7ce99c8135d542989f3542afb96dd667">The API used to obtain a user token does not require authentication. Therefore, only the <strong id="EN-US_TOPIC_0000001185673174__b5131103910610">Content-type</strong> field needs to be added to requests for calling the API. An example of such requests is as follows:</p>
 </div>
 <pre class="screen" id="EN-US_TOPIC_0000001185673174__screen1661199175017">POST https://iam.eu-de.otc.t-systems.com/v3/auth/tokens
 Content-type: application/json</pre>
 <div class="section" id="EN-US_TOPIC_0000001185673174__s21ef4bef3df240f894aa42ca2d98b09d"><h4 class="sectiontitle">Request Body</h4><p id="EN-US_TOPIC_0000001185673174__a3bf1f51bf4824445bf1c20e429a46bf9">The body of a request is often sent in a structured format (JSON or XML) as specified in the <strong id="EN-US_TOPIC_0000001185673174__b632016401402">Content-type</strong> header field. The request body transfers content except the request header. If the request body contains Chinese characters, these characters must be coded in UTF-8.</p>
 <p id="EN-US_TOPIC_0000001185673174__a50662a6ce4c846e7953ee4878b1ba180">The request body varies between APIs. Some APIs do not require the request body, such as the APIs requested using the GET and DELETE methods.</p>
-<p id="EN-US_TOPIC_0000001185673174__a07dd23d016a54619aaf564145a0d5359">In the case of the API used to obtain a user token, the request parameters and parameter description can be obtained from the API request. The following provides an example request with a body included. Replace <em id="EN-US_TOPIC_0000001185673174__i197652019142215"><strong id="EN-US_TOPIC_0000001185673174__b07651719182216">user_name</strong></em>, <em id="EN-US_TOPIC_0000001185673174__i8766131962213"><strong id="EN-US_TOPIC_0000001185673174__b1276631915221">domainname</strong></em> (account name), <strong id="EN-US_TOPIC_0000001185673174__b67671319112220"><em id="EN-US_TOPIC_0000001185673174__i207661819192216">********</em></strong> (login password), and <strong id="EN-US_TOPIC_0000001185673174__b9768101918228"><em id="EN-US_TOPIC_0000001185673174__i176719198222">xxxxxxxxxxxxxxxxxx</em></strong> (project ID) with actual ones. Obtain the project ID from the database administrator.</p>
+<p id="EN-US_TOPIC_0000001185673174__a07dd23d016a54619aaf564145a0d5359">In the case of the API used to obtain a user token, the request parameters and parameter description can be obtained from the API request. The following provides an example request with a body included. Replace <em id="EN-US_TOPIC_0000001185673174__i162061515576"><strong id="EN-US_TOPIC_0000001185673174__b3206615777">user_name</strong></em>, <em id="EN-US_TOPIC_0000001185673174__i020661513718"><strong id="EN-US_TOPIC_0000001185673174__b220618150717">domainname</strong></em> (account name), <strong id="EN-US_TOPIC_0000001185673174__b22064151372"><em id="EN-US_TOPIC_0000001185673174__i1820613152715">********</em></strong> (login password), and <strong id="EN-US_TOPIC_0000001185673174__b1620616151717"><em id="EN-US_TOPIC_0000001185673174__i17206415572">xxxxxxxxxxxxxxxxxx</em></strong> (project ID) with actual ones. Obtain the project ID from the database administrator.</p>
 <div class="note" id="EN-US_TOPIC_0000001185673174__n63aedb76c20e4323affd745b04933f46"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001185673174__a8dac7f39ed004dada7547fcfb9a40b22">The <strong id="EN-US_TOPIC_0000001185673174__b55015220182">scope</strong> parameter specifies where a token takes effect. In the example, the token takes effect only on the resources specified by the project. In the following example, the token takes effect only for the resources in a specified project. For more information about this API, see Obtaining a User Token.</p>
 </div></div>
 <pre class="screen" id="EN-US_TOPIC_0000001185673174__se0d2d43430e24faea81ddd913e36a0e5">POST https://iam.eu-de.otc.t-systems.com/v3/auth/tokens

docs/dws/api-ref/dws_02_0064.html

@@ -5,7 +5,7 @@
 <div class="section" id="EN-US_TOPIC_0000001231391263__se42eaf07b9464e7b8becd7c3cb824afb"><h4 class="sectiontitle">Token-based Authentication</h4><p id="EN-US_TOPIC_0000001231391263__a5e74a303f7e7490e973e81e4d0a3e6fb">A token specifies temporary permissions in a computer system. During API authentication using a token, the token is added to request headers to get permissions for calling the API.</p>
 <div class="note" id="EN-US_TOPIC_0000001231391263__note185371034218"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001231391263__p1753714319217">The validity period of a token is 24 hours. When using a token for authentication, cache it to prevent frequently calling the IAM API used to obtain a user token.</p>
 </div></div>
-<p id="EN-US_TOPIC_0000001231391263__p1160363317231">When calling the API to obtain a user token, you must set <strong id="EN-US_TOPIC_0000001231391263__b357314505014">auth.scope</strong> in the request body to <strong id="EN-US_TOPIC_0000001231391263__b12450131312504">project</strong>.</p>
+<p id="EN-US_TOPIC_0000001231391263__p1160363317231">When calling the API to obtain a user token, you must set <strong id="EN-US_TOPIC_0000001231391263__b4383338475">auth.scope</strong> in the request body to <strong id="EN-US_TOPIC_0000001231391263__b123831038179">project</strong>.</p>
 <pre class="screen" id="EN-US_TOPIC_0000001231391263__screen1954692813282">{ 
     "auth": { 
         "identity": { 
@@ -29,7 +29,7 @@
 <strong id="EN-US_TOPIC_0000001231391263__b6546162815283">        }</strong> 
     } 
 }</pre>
-<p id="EN-US_TOPIC_0000001231391263__a212a74e9785342f9a44bb4d6d62c25f1">After a token is obtained, the <strong id="EN-US_TOPIC_0000001231391263__b15928143912512">X-Auth-Token</strong> header field must be added to requests to specify the token when calling other APIs. For example, if the token is <span class="parmvalue" id="EN-US_TOPIC_0000001231391263__parmvalue27267718616"><b>ABCDEFJ....</b></span>, <span class="parmvalue" id="EN-US_TOPIC_0000001231391263__parmvalue4100115163"><b>X-Auth-Token: ABCDEFJ....</b></span> can be added to a request.</p>
+<p id="EN-US_TOPIC_0000001231391263__a212a74e9785342f9a44bb4d6d62c25f1">After a token is obtained, the <strong id="EN-US_TOPIC_0000001231391263__b15928143912512">X-Auth-Token</strong> header field must be added to requests to specify the token when calling other APIs. If the token is <span class="parmvalue" id="EN-US_TOPIC_0000001231391263__parmvalue34114919715"><b>ABCDEFG....</b></span>, add <span class="parmvalue" id="EN-US_TOPIC_0000001231391263__parmvalue154114491876"><b>X-Auth-Token: ABCDEFG....</b></span> to a request.</p>
 </div>
 </div>
 <div>

docs/dws/api-ref/dws_02_0066.html

@@ -13,7 +13,7 @@
 </li>
 <li class="ulchildlink"><strong><a href="dws_02_0011.html">Obtaining a Project ID</a></strong><br>
 </li>
-<li class="ulchildlink"><strong><a href="dws_02_0067.html">Obtaining an Account ID</a></strong><br>
+<li class="ulchildlink"><strong><a href="dws_02_0067.html">Obtaining an Account</a></strong><br>
 </li>
 <li class="ulchildlink"><strong><a href="dws_02_00068.html">Obtaining the Cluster ID</a></strong><br>
 </li>

docs/dws/api-ref/dws_02_0067.html

@@ -1,8 +1,8 @@
 <a name="EN-US_TOPIC_0000001231631315"></a><a name="EN-US_TOPIC_0000001231631315"></a>
 
-<h1 class="topictitle1">Obtaining an Account ID</h1>
-<div id="body8662426"><p id="EN-US_TOPIC_0000001231631315__a2bf578b6ede2475991f4a636cc4c559d">An account ID is required for some URLs when an API is called. To obtain the account ID, perform the following steps:</p>
-<ol id="EN-US_TOPIC_0000001231631315__oe9c190f940244d3eac2560d625b2d433"><li id="EN-US_TOPIC_0000001231631315__l9f6fc4c033c443679e30407beddb0a49">Log in to the management console.</li><li id="EN-US_TOPIC_0000001231631315__l53b1f18b1c6e46f9aff8c9aaef26a025">Click the username and select <span class="uicontrol" id="EN-US_TOPIC_0000001231631315__uicontrol17963114114206"><b>My Credential</b></span> from the drop-down list.<p id="EN-US_TOPIC_0000001231631315__en-us_topic_0170949686_p136772519449">On the <strong id="EN-US_TOPIC_0000001231631315__en-us_topic_0170949686_b151241857155215">My Credential</strong> page, view the <strong id="EN-US_TOPIC_0000001231631315__b1433342102">Account ID</strong>.</p>
+<h1 class="topictitle1">Obtaining an Account</h1>
+<div id="body8662426"><p id="EN-US_TOPIC_0000001231631315__a2bf578b6ede2475991f4a636cc4c559d">An account ID (<strong id="EN-US_TOPIC_0000001231631315__b061710161318">domain-id</strong>) is required for some URLs when an API is called. To obtain the account ID, do as follows:</p>
+<ol id="EN-US_TOPIC_0000001231631315__oe9c190f940244d3eac2560d625b2d433"><li id="EN-US_TOPIC_0000001231631315__l9f6fc4c033c443679e30407beddb0a49">Log in to the management console.</li><li id="EN-US_TOPIC_0000001231631315__l53b1f18b1c6e46f9aff8c9aaef26a025">Click the username and select <span class="uicontrol" id="EN-US_TOPIC_0000001231631315__uicontrol17963114114206"><b>My Credential</b></span> from the drop-down list.<p id="EN-US_TOPIC_0000001231631315__en-us_topic_0170949686_p136772519449">On the <strong id="EN-US_TOPIC_0000001231631315__b013711020149">My Credential</strong> page, view the <strong id="EN-US_TOPIC_0000001231631315__b71374012146">Account ID</strong>.</p>
 </li></ol>
 </div>
 <div>

docs/dws/tool/DWS_DS_001.html

@@ -0,0 +1,21 @@
+<a name="EN-US_TOPIC_0000001860198933"></a><a name="EN-US_TOPIC_0000001860198933"></a>
+
+<h1 class="topictitle1">About Data Studio</h1>
+<div id="body8662426"></div>
+<div>
+<ul class="ullinks">
+<li class="ulchildlink"><strong><a href="dws_07_0012.html">Overview</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_003.html">Constraints and Limitations</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_004.html">System Requirements</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_005.html">Customizing Data Studio</a></strong><br>
+</li>
+</ul>
+
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_ds_index.html">Data Studio</a></div>
+</div>
+</div>
+

docs/dws/tool/DWS_DS_003.html

@@ -0,0 +1,29 @@
+<a name="EN-US_TOPIC_0000001813598852"></a><a name="EN-US_TOPIC_0000001813598852"></a>
+
+<h1 class="topictitle1">Constraints and Limitations</h1>
+<div id="body8662426"><p id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_p56771492">This section describes the constraints and limitations for using Data Studio.</p>
+<div class="section" id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_section52241050165417"><h4 class="sectiontitle">Character Encoding</h4><p id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_p41011754195417">If the SQL statement, DDL, object name, or data to be viewed contains Chinese characters, set the character encoding to <strong id="EN-US_TOPIC_0000001813598852__b154250884320">GBK</strong> if it is supported by the OS.</p>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_section1193812917437"><h4 class="sectiontitle">Connection Management</h4><p id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_p79402294439">On the <strong id="EN-US_TOPIC_0000001813598852__b11368653154317">Advanced</strong> tab of the <strong id="EN-US_TOPIC_0000001813598852__b1137535313431">New Connection</strong> and <strong id="EN-US_TOPIC_0000001813598852__b23751553134311">Edit Connection</strong> pages, commas (,) are used as separators in the <strong id="EN-US_TOPIC_0000001813598852__b03751253154311">include</strong> and <strong id="EN-US_TOPIC_0000001813598852__b17376135317439">exclude</strong> columns. Therefore, a schema name that contains a comma (,) is not supported.</p>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_section1974318494412"><h4 class="sectiontitle">Database Tables</h4><ul id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_ul12564165810017"><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li19564158000">On the <strong id="EN-US_TOPIC_0000001813598852__b53391243142912">Index</strong> tab of the table creation wizard, the sequence of the selected columns in the list view cannot be retained after columns are deleted.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li24251031520">When an operation has completed, and if the Data Studio window is not the active window of the operating system, then the message dialog is shown only when the Data Studio window becomes active.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li1181515274311">The following limitations are applicable to operations in <a href="DWS_DS_98.html#EN-US_TOPIC_0000001860318649__section1226872111129">Editing Table Data</a>:<ul id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_ul481518276310"><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li1888210217336">Entering expression values in the <strong id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_b1924391921516">Edit Table Data</strong> tab is not supported.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li481513270310">Data Studio allows editing of fetched records only.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li114480571242">The Editing table filter feature will not highlight search words within HTML tags such as &lt;, &amp;, &gt;.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li142787061015">A cell containing single '&amp;' in it will not be displayed in the tooltip. A cell containing two consecutive '&amp;' will display as a single '&amp;' in the tooltip.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li453981315191">Row focus is not retained on a newly added row. You need to click the desired cell.</li></ul>
+</li></ul>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_section11546138161314"><h4 class="sectiontitle">Function/Procedure</h4><p id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_p921473031313">Functions/Procedures created in the SQL Terminal or the <strong id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_b850941984416">Create Function/Procedure</strong> wizard must end with "/" to indicate the end of functions/procedures. Statements entered after a function/procedure without "/" at the end will be treated as a single query and may trigger errors during execution.</p>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_section9547959114210"><h4 class="sectiontitle">General</h4><ul id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_ul14774183914810"><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li207745396482">A maximum of 100 tabs can be opened in the editor area. Tabs are based on available resources of the host machine.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li975113111491">A maximum of 64 characters (text only) are allowed for database object names (database, schema, function, procedure, table, sequence, constraint, index, view, and tablespace). There is no limit to the number of characters that can be used in expressions and descriptions in Data Studio.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li26311102517">A maximum of 300 result tabs can be opened on a logged instance of Data Studio.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li770311102418">If there are large objects loaded in Object Browser and Search Object window, expanding of objects in Object Browser may be slow and Data Studio may become unresponsive.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li15061954102518">Adjusting the cell width may cause Data Studio to fail to respond.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li203261622153010">When the data in a table cell is more than 1,000 characters, it will be trimmed to 1,000 characters with "..." at the end.<ul id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_ul43261822113019"><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li15876943119">If you copy the data from a cell in a table or the <strong id="EN-US_TOPIC_0000001813598852__b1673933101915">Result</strong> tab to any editor, such as SQL terminal/PLSQL source editor, notepad, or any other external editor application, all data is pasted.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li857719339339">If you copy the data from a cell in a table or the <strong id="EN-US_TOPIC_0000001813598852__b19401217171913">Result</strong> tab to an editable cell, the cell displays only the first 1,000 characters and the excess characters are displayed as <strong id="EN-US_TOPIC_0000001813598852__b18940131718192">...</strong>.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li3127204116351">When the table/<strong id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_b1872820162570">Result</strong> tab data is exported, the exported file contains the whole data.</li></ul>
+</li></ul>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_section13086181462"><h4 class="sectiontitle">Security</h4><p id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_p4380123612344">Data Studio validates SSL connection parameters only for the first time of connection. If <strong id="EN-US_TOPIC_0000001813598852__b1973015614319">Enable SSL</strong> is selected, the same SSL connection parameters are used when a new connection is opened.</p>
+<div class="note" id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_note115077461378"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001813598852__ul94672211310"><li id="EN-US_TOPIC_0000001813598852__li7461022111318">If <strong id="EN-US_TOPIC_0000001813598852__b17307488124">Enable SSL</strong> is not selected during connecting to Data Studio, data is not encrypted by default.</li><li id="EN-US_TOPIC_0000001813598852__li1216413265132">If the security file is damaged during the SSL connection, Data Studio cannot perform any database operations. To resolve this problem, delete the security folder in the corresponding configuration folder and restart Data Studio.</li></ul>
+</div></div>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_section4547124918432"><h4 class="sectiontitle">SQL Terminal</h4><ul id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_ul117701935125112"><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li377053513514">Opening an SQL file containing a large number of queries may result in an 'Insufficient Memory' error. For details, see <a href="DWS_DS_039.html">Troubleshooting</a>.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li6958142915537">Data Studio does not disable the auto-suggest and hyperlink features in the commented text in the <strong id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_b6475250142117">SQL Terminal</strong>.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li1882614365384">The Hyperlink feature is not supported if the schema or table name have either spaces or dots (.) in them.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li1609134210592">Auto-suggest is not supported if the object name contains single or double quotes in it.</li><li id="EN-US_TOPIC_0000001813598852__en-us_topic_0185264129_li1885095241314">DS supports basic formatting of simple SELECT statements only and may not work as expected for complex queries.</li></ul>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="DWS_DS_001.html">About Data Studio</a></div>
+</div>
+</div>
+

docs/dws/tool/DWS_DS_008.html

@@ -0,0 +1,66 @@
+<a name="EN-US_TOPIC_0000001860198653"></a><a name="EN-US_TOPIC_0000001860198653"></a>
+
+<h1 class="topictitle1">Configuring SSL Connection</h1>
+<div id="body8662426"><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001584150033_en-us_topic_0000001510164849_en-us_topic_0185264675_p1174011206154">Data Studio can connect to the database using the Secure Sockets Layer [SSL] option. To use the SSL connection mode, you must configure related parameters on the client or in the application code. The GaussDB(DWS) management console provides the SSL certificate required by the client. The SSL certificate contains the default certificate, private key, root certificate, and private key password encryption file required by the client.</p>
+<div class="section" id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_section9914102616204"><h4 class="sectiontitle">Server Configuration</h4><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_p695305681112">After a cluster is deployed, GaussDB(DWS) enables the SSL authentication mode by default. The server certificate, private key, and root certificate have been configured.</p>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001860198653__section14841501497"><h4 class="sectiontitle">SSL Certificate and Client Configuration</h4><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_p1366818145418">You need to configure the client.</p>
+<ol id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_ol1827634419214"><li id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_li129241946103115"><span>You can download an SSL certificate from GaussDB(DWS).</span><p><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_p1063804811313">Log in to the GaussDB(DWS) management console. In the navigation pane, choose <span class="uicontrol" id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001533190636_en-us_topic_0000001523826708_en-us_topic_0000001514019285_uicontrol85392169713"><b>Connections</b></span>. In the <span class="parmname" id="EN-US_TOPIC_0000001860198653__parmname028771917294"><b>Driver</b></span> area, click <span class="uicontrol" id="EN-US_TOPIC_0000001860198653__uicontrol12288141913297"><b>download an SSL certificate</b></span>.</p>
+</p></li><li id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_li1180291411225"><span>Decompress the downloaded <strong id="EN-US_TOPIC_0000001860198653__b0162028132915">dws_ssl_cert.zip</strong> package to obtain the certificate file. Click the <strong id="EN-US_TOPIC_0000001860198653__b17391634182911">SSL</strong> tab on the Data Studio client and set the following parameters:</span><p>
+<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_tc6a4177683ae43a5a21e02a558b115d1" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Configuring SSL parameters</caption><thead align="left"><tr id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_re85a10ea61f04c57a14374ca5c7d6050"><th align="left" class="cellrowborder" valign="top" width="19.38%" id="mcps1.3.3.3.2.2.1.2.3.1.1"><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_a033d348bbfd54eb4bbc8cfdcbe364f7c">Parameter</p>
+</th>
+<th align="left" class="cellrowborder" valign="top" width="80.62%" id="mcps1.3.3.3.2.2.1.2.3.1.2"><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0107187019_p19137554319">Description</p>
+</th>
+</tr>
+</thead>
+<tbody><tr id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_ra35932b78ca140b7a5439c9f7e3107ad"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.3.3.2.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_a9ad6035d6045458ebf34506c32399247">Client SSL Certificate</p>
+</td>
+<td class="cellrowborder" valign="top" width="80.62%" headers="mcps1.3.3.3.2.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_a8107c62bfd1d4ecfacf90307da3294d9">Select the <span class="filepath" id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_fea612bd9aaa44bd29b4bbc294e86e824"><b>sslcert\client.crt</b></span> file in the decompressed SSL certificate directory.</p>
+</td>
+</tr>
+<tr id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_r4a637f73e2164fa1bb65347c59e962cf"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.3.3.2.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0107187019_p121516558317">Client SSL Key</p>
+</td>
+<td class="cellrowborder" valign="top" width="80.62%" headers="mcps1.3.3.3.2.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_a5a76dbcc4fa74168be4ddd10f99571c7">Only the PK8 format is supported. Select the <span class="filepath" id="EN-US_TOPIC_0000001860198653__filepath324716443019"><b>sslcert\client.key.pk8</b></span> file in the directory where the SSL certificate is decompressed.</p>
+</td>
+</tr>
+<tr id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_re654cf33e6fd4162a322d30a10112453"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.3.3.2.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0107187019_p91575583118">Root Certificate</p>
+</td>
+<td class="cellrowborder" valign="top" width="80.62%" headers="mcps1.3.3.3.2.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_ace66c1ada5ef40aba396d828d1cb5546">When <span class="parmname" id="EN-US_TOPIC_0000001860198653__parmname98748209304"><b>SSL Mode</b></span> is set to <span class="parmvalue" id="EN-US_TOPIC_0000001860198653__parmvalue587472010302"><b>verify-ca</b></span> or <span class="parmvalue" id="EN-US_TOPIC_0000001860198653__parmvalue1187472023018"><b>verify-full</b></span>, the root certificate must be configured. Select the <span class="filepath" id="EN-US_TOPIC_0000001860198653__filepath118741120173019"><b>sslcert\cacert.pem</b></span> file in the decompressed SSL certificate directory.</p>
+</td>
+</tr>
+<tr id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_rc13e8815e6954b508b90480dd8dfc491"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.3.3.2.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0107187019_p516125517315">SSL Password</p>
+</td>
+<td class="cellrowborder" valign="top" width="80.62%" headers="mcps1.3.3.3.2.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0107187019_p21655516313">Set the password for the client SSL key in PK8 format.</p>
+</td>
+</tr>
+<tr id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_r422d1cb572a34d88ae84caa91c68f153"><td class="cellrowborder" valign="top" width="19.38%" headers="mcps1.3.3.3.2.2.1.2.3.1.1 "><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0107187019_p616115515312">SSL Mode</p>
+</td>
+<td class="cellrowborder" valign="top" width="80.62%" headers="mcps1.3.3.3.2.2.1.2.3.1.2 "><p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_aae9d413250a648b4b7f97d2aca66b196">GaussDB(DWS) supports the following SSL modes:</p>
+<ul id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_uef8cf175c60947de9f9cccfa40627114"><li id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_led5000cbf972424193937b27da18335c"><strong id="EN-US_TOPIC_0000001860198653__b471010427309">require</strong>: The SSL factory does not require verification, nor does it check the certificate validity.</li><li id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_lc88d3ca75992452cb37cfad2d3706233"><strong id="EN-US_TOPIC_0000001860198653__b105111112312">verify-ca</strong>: The certificate authority (CA) will be verified using the corresponding SSL factory.</li><li id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_li364454519273"><strong id="EN-US_TOPIC_0000001860198653__b44127218981222">verify-full</strong>: The CA and database will be verified using the corresponding SSL factory.</li></ul>
+<p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_a294fdd7a18c04b48a350671d148ab611">GaussDB(DWS) does not support the <strong id="EN-US_TOPIC_0000001860198653__b158394606081222">verify-full</strong> mode.</p>
+</td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="note" id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0185264624_note156817411317"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0185264624_ul1268111443113"><li id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0185264624_li66804413113">You can select a valid <strong id="EN-US_TOPIC_0000001860198653__b910920103216">Client SSL Certificate</strong> and <strong id="EN-US_TOPIC_0000001860198653__b15112303320">Client SSL Key</strong> to export DDL and data from Data Studio using secure connections.</li><li id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0185264624_li36816453115">If the selected <strong id="EN-US_TOPIC_0000001860198653__b171511542326">Client SSL Certificate</strong> and <strong id="EN-US_TOPIC_0000001860198653__b1015185463213">Client SSL Key</strong> are invalid, the export will fail. For details, see <a href="DWS_DS_039.html">Troubleshooting</a>.</li><li id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0185264624_li812317223710">If you deselect <strong id="EN-US_TOPIC_0000001860198653__b177891173333">Enable SSL</strong> and proceed, the <strong id="EN-US_TOPIC_0000001860198653__b16789161733311">Connection Security Alert</strong> dialog box is displayed. Refer to <a href="DWS_DS_005.html#EN-US_TOPIC_0000001813438860__table1510418570339">Table 1</a> to determine whether to display this dialog box.<ul id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0185264624_ul201301215378"><li id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0185264624_li51321828375"><strong id="EN-US_TOPIC_0000001860198653__b4252174419337">Continue</strong>: Continues to use insecure connections.</li><li id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0185264624_li3136152133711"><strong id="EN-US_TOPIC_0000001860198653__b12440583181222">Cancel</strong>: Enables SSL.</li><li id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0185264624_li1514015293713"><strong id="EN-US_TOPIC_0000001860198653__b132781854203314">Do not show again</strong>: If you select this option, the <strong id="EN-US_TOPIC_0000001860198653__b127885410339">Connection Security Alert</strong> dialog box is not displayed for the subsequent connections of logged Data Studio instances.</li></ul>
+</li><li id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_en-us_topic_0185264624_li1743992617411">Data Studio prompts you to enter the client key upon the first access to the <strong id="EN-US_TOPIC_0000001860198653__b1016104572413">gs_dump</strong> feature.</li></ul>
+</div></div>
+<div class="fignone" id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_fig7683711879"><span class="figcap"><b>Figure 1 </b>SSL parameters</span><br><span><img id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_i232821e5252d4ed9b71faf166456bbba" src="figure/en-us_image_0000001860199137.png" width="465.5" height="232.044967" title="Click to enlarge" class="imgResize"></span></div>
+<p id="EN-US_TOPIC_0000001860198653__en-us_topic_0000001510164849_en-us_topic_0000001290232596_p3338151808"></p>
+</p></li></ol>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_ds_index.html">Data Studio</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/dws/tool/DWS_DS_012.html

@@ -0,0 +1,31 @@
+<a name="EN-US_TOPIC_0000001813439188"></a><a name="EN-US_TOPIC_0000001813439188"></a>
+
+
+  <h1 class="topictitle1">Database Management</h1>
+
+  <div id="body0000001582212125"><p id="EN-US_TOPIC_0000001813439188__p8060118"></p>
+</div>
+
+<div>
+<ul class="ullinks">
+<li class="ulchildlink"><strong><a href="DWS_DS_013.html">Database Management</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_014.html">Schema Management</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_015.html">Function/Procedure Management</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_016.html">Table Management</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_022.html">View Management</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_023.html">Sequence Management</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_024.html">Users/Roles</a></strong><br>
+</li>
+</ul>
+
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_ds_index.html">Data Studio</a></div>
+</div>
+</div>
+

docs/dws/tool/DWS_DS_013.html

@@ -0,0 +1,64 @@
+<a name="EN-US_TOPIC_0000001813598724"></a><a name="EN-US_TOPIC_0000001813598724"></a>
+
+<h1 class="topictitle1">Database Management</h1>
+<div id="body1584524312098"><p id="EN-US_TOPIC_0000001813598724__p10107145123117">A relational database contains a set of tables that can be operated based on the relational model of data. A relational database contains a group of data objects for storing, managing, and accessing data objects, including tables, views, indexes, and functions.</p>
+<div class="section" id="EN-US_TOPIC_0000001813598724__section1966415102453"><h4 class="sectiontitle">Creating a Database</h4><ol id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264253_ol43338546191357"><li id="EN-US_TOPIC_0000001813598724__li710181734620"><span>In the <strong id="EN-US_TOPIC_0000001813598724__b74741418172413">Object Browser</strong> pane, right-click the <strong id="EN-US_TOPIC_0000001813598724__b67973239241">Databases</strong> group and select <strong id="EN-US_TOPIC_0000001813598724__b1778133018245">Create Database</strong>.</span><p><p id="EN-US_TOPIC_0000001813598724__p1220115238467"><span><img id="EN-US_TOPIC_0000001813598724__image887515236463" src="figure/en-us_image_0000001860319089.png"></span></p>
+<p id="EN-US_TOPIC_0000001813598724__p1364973714231"></p>
+</p></li><li id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264253_li54502602191357"><span>A <strong id="EN-US_TOPIC_0000001813598724__b4742292255">Create Database</strong> dialog box is displayed, prompting you to provide the information required for creating a database.</span><p><ul id="EN-US_TOPIC_0000001813598724__ul665913224719"><li id="EN-US_TOPIC_0000001813598724__li889018494718">Enter a database name.</li><li id="EN-US_TOPIC_0000001813598724__li106591925475">Select the required type of encoding character set from the <strong id="EN-US_TOPIC_0000001813598724__b1012813612618">Database Encoding</strong> drop-down list. The database supports <strong id="EN-US_TOPIC_0000001813598724__b13408164022612">UTF-8</strong>, <strong id="EN-US_TOPIC_0000001813598724__b6820548112613">GBK</strong>, <strong id="EN-US_TOPIC_0000001813598724__b13628185314262">SQL_ASCII</strong>, and <strong id="EN-US_TOPIC_0000001813598724__b1432218565261">LATIN1</strong> encoding character sets. Creating the database with other encoding character sets may result in erroneous operations.<div class="note" id="EN-US_TOPIC_0000001813598724__note658281464617"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001813598724__p19582191414465">This operation can be performed only when there is at least one active database.</p>
+</div></div>
+</li></ul>
+</p></li><li id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264253_li4970961191557"><span>Select <strong id="EN-US_TOPIC_0000001813598724__b7862123393117">Connect to the DB</strong> and click <strong id="EN-US_TOPIC_0000001813598724__b15737036103117">OK</strong>.</span><p><p id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264253_p86148358314">The status bar displays the status of the completed operation.</p>
+<p id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264253_p67060858191557">You can view the created database in the <strong id="EN-US_TOPIC_0000001813598724__b431815103213">Object Browser</strong>. The system-related schema in the server is automatically added to the new database.</p>
+</p></li></ol>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598724__section17324144444314"><h4 class="sectiontitle">Connecting to the Database</h4><div class="p" id="EN-US_TOPIC_0000001813598724__p719916664520">In the <strong id="EN-US_TOPIC_0000001813598724__b14204845104115">Object Browser</strong> pane, right-click the database name and choose <strong id="EN-US_TOPIC_0000001813598724__b2199125512415">Connect to DB</strong>. The status bar displays the status of the completed operation.<div class="note" id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264796_note9290227172018"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264796_p1429115272202">This operation can be performed on a disconnected database.</p>
+</div></div>
+</div>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598724__section118585814210"><h4 class="sectiontitle">Renames a Database</h4><ol id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264765_ol52617682"><li id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264765_li1326316398230"><span>In the <strong id="EN-US_TOPIC_0000001813598724__b1030535118123">Object Browser</strong> pane, right-click the selected database and select <strong id="EN-US_TOPIC_0000001813598724__b6942556124">Rename Database</strong>.</span><p><div class="note" id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264765_note9290227172018"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264765_p1429115272202">This operation can be performed on a disconnected database.</p>
+</div></div>
+<p id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264765_p186378222577">The <strong id="EN-US_TOPIC_0000001813598724__b633921317131">Rename Database</strong> dialog box is displayed, prompting you to provide the information required for renaming the database.</p>
+</p></li><li id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264765_li544761915710"><span>Enter a new database name. Select the <strong id="EN-US_TOPIC_0000001813598724__b1421273741314">Connect to the DB</strong> check box and click <strong id="EN-US_TOPIC_0000001813598724__b1944974016132">OK</strong>.</span><p><p id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264765_p48165881">A confirmation dialog box is displayed, promoting you to confirm the renaming operation.</p>
+</p></li></ol>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598724__section61561548194015"><h4 class="sectiontitle">Disconnecting from a Database</h4><p id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264463_p185292101458">You can disconnect all databases or a specified database under a connection by using the disconnection function.</p>
+<ol id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264463_ol19137160"><li id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264463_li38016717"><span>In the <strong id="EN-US_TOPIC_0000001813598724__b19014581448921">Object Browser</strong> pane, right-click the selected the <strong id="EN-US_TOPIC_0000001813598724__b17253803038921">Databases</strong> group and select <strong id="EN-US_TOPIC_0000001813598724__b4182349488921">Disconnect All</strong>. This will disconnect all the databases under the connection.</span><p><p id="EN-US_TOPIC_0000001813598724__p136321916134211"><span><img id="EN-US_TOPIC_0000001813598724__image43691510420" src="figure/en-us_image_0000001860199253.png"></span></p>
+<div class="p" id="EN-US_TOPIC_0000001813598724__p144271357192410"><div class="note" id="EN-US_TOPIC_0000001813598724__note33731314104212"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001813598724__p33731014154217">This operation can be performed only when there is at least one active database.</p>
+</div></div>
+</div>
+<p class="figure" id="EN-US_TOPIC_0000001813598724__p15373111444218">A confirmation dialog box is displayed, prompting you to confirm the disconnection operation.</p>
+</p></li><li id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264849_li189699588235"><span>In the <strong id="EN-US_TOPIC_0000001813598724__b792201919276">Object Browser</strong> pane, right-click the selected database name and select <strong id="EN-US_TOPIC_0000001813598724__b992331972711">Disconnect from DB</strong>.</span><p><p id="EN-US_TOPIC_0000001813598724__p17957351124212"><span><img id="EN-US_TOPIC_0000001813598724__image1714235044211" src="figure/en-us_image_0000001813439392.png"></span></p>
+<div class="p" id="EN-US_TOPIC_0000001813598724__p185514832516"><div class="note" id="EN-US_TOPIC_0000001813598724__note18581204944217"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001813598724__p19581134918426">This operation can be performed only on the primary database.</p>
+</div></div>
+</div>
+</p></li></ol>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598724__section1896932163717"><h4 class="sectiontitle">Dropping a Database</h4><p id="EN-US_TOPIC_0000001813598724__p183031942173911">In the <strong id="EN-US_TOPIC_0000001813598724__b1198118306285">Object Browser</strong> pane, right-click the selected database and select <strong id="EN-US_TOPIC_0000001813598724__b9485939152819">Drop Database</strong>. A confirmation dialog box is displayed, asking you whether to delete the database.</p>
+<p id="EN-US_TOPIC_0000001813598724__p115178591390"><span><img id="EN-US_TOPIC_0000001813598724__image1065793111403" src="figure/en-us_image_0000001813599180.png"></span></p>
+<div class="p" id="EN-US_TOPIC_0000001813598724__p184102581263"><div class="note" id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264752_note9290227172018"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264752_p1429115272202">This operation can be performed on a disconnected database.</p>
+</div></div>
+</div>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598724__section443822715352"><h4 class="sectiontitle">Viewing Data Properties</h4><p id="EN-US_TOPIC_0000001813598724__p956314471368">Right-click the selected database and select <strong id="EN-US_TOPIC_0000001813598724__b52801720103016">Properties</strong>. The status bar displays the status of the completed operation.</p>
+<p id="EN-US_TOPIC_0000001813598724__p189240531367"><span><img id="EN-US_TOPIC_0000001813598724__image27360953712" src="figure/en-us_image_0000001813599176.png"></span></p>
+<p id="EN-US_TOPIC_0000001813598724__p1317274119271"></p>
+<p id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264208_p202202033288">The properties of the selected database are displayed.</p>
+<p id="EN-US_TOPIC_0000001813598724__p19797154513610"><span><img id="EN-US_TOPIC_0000001813598724__image1148182617373" src="figure/en-us_image_0000001860199237.png" width="518.7" height="181.43859999999998" title="Click to enlarge" class="imgResize"></span></p>
+<p id="EN-US_TOPIC_0000001813598724__p569715102813"></p>
+<div class="note" id="EN-US_TOPIC_0000001813598724__en-us_topic_0185264208_note13220537280"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001813598724__ul931815347365"><li id="EN-US_TOPIC_0000001813598724__li0318834133619">This operation can be performed only when there is at least one active database.</li><li id="EN-US_TOPIC_0000001813598724__li113409361364">If the property of an opened database is modified, then refresh and open the properties of the database again to view the updated information on the same opened window.</li></ul>
+</div></div>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="DWS_DS_012.html">Database Management</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/dws/tool/DWS_DS_016.html

@@ -0,0 +1,23 @@
+<a name="EN-US_TOPIC_0000001813439196"></a><a name="EN-US_TOPIC_0000001813439196"></a>
+
+<h1 class="topictitle1">Table Management</h1>
+<div id="body1584526252525"></div>
+<div>
+<ul class="ullinks">
+<li class="ulchildlink"><strong><a href="DWS_DS_017.html">Creating a Regular Table</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_018.html">Creating a Partitioned Table</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_98.html">Managing Table Data</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_020.html">Editing Temporary Tables</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_021.html">Creating a Foreign Table</a></strong><br>
+</li>
+</ul>
+
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="DWS_DS_012.html">Database Management</a></div>
+</div>
+</div>
+

docs/dws/tool/DWS_DS_017.html

@@ -0,0 +1,21 @@
+<a name="EN-US_TOPIC_0000001860198601"></a><a name="EN-US_TOPIC_0000001860198601"></a>
+
+<h1 class="topictitle1">Creating a Regular Table</h1>
+<div id="body1584526252525"></div>
+<div>
+<ul class="ullinks">
+<li class="ulchildlink"><strong><a href="DWS_DS_72.html">Defining a Regular Table</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_73.html">Managing Columns</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_74.html">Managing Constraints</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_75.html">Managing Indexes</a></strong><br>
+</li>
+</ul>
+
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="DWS_DS_016.html">Table Management</a></div>
+</div>
+</div>
+

docs/dws/tool/DWS_DS_020.html

@@ -0,0 +1,25 @@
+<a name="EN-US_TOPIC_0000001860318829"></a><a name="EN-US_TOPIC_0000001860318829"></a>
+
+<h1 class="topictitle1">Editing Temporary Tables</h1>
+<div id="body1584526252528"><p id="EN-US_TOPIC_0000001860318829__en-us_topic_0185264258_p12741154010512">Data Studio allows you to edit temporary tables. Temporary tables are deleted automatically when you close the connection that was used to create the table.</p>
+<div class="notice" id="EN-US_TOPIC_0000001860318829__en-us_topic_0185264258_note13585727155116"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0000001860318829__en-us_topic_0185264258_p166020271511">Ensure that connection reuse is enabled when you use edit temporary tables in <strong id="EN-US_TOPIC_0000001860318829__b154199081">SQL Terminal</strong>. For details, see <a href="DWS_DS_037.html">Managing Connections in the SQL Terminal</a>.</p>
+</div></div>
+<p id="EN-US_TOPIC_0000001860318829__en-us_topic_0185264258_p1266242785111">Follow the steps to edit a temporary table:</p>
+<ol id="EN-US_TOPIC_0000001860318829__en-us_topic_0185264258_ol56621327145111"><li id="EN-US_TOPIC_0000001860318829__en-us_topic_0185264258_li0662827185112"><span>Execute a query on the temporary table.</span><p><p id="EN-US_TOPIC_0000001860318829__en-us_topic_0185264258_p26621127135120">The <strong id="EN-US_TOPIC_0000001860318829__b44910513351">Result</strong> tab displays the results of the SQL query along with the query statement executed.</p>
+</p></li><li id="EN-US_TOPIC_0000001860318829__en-us_topic_0185264258_li1662172714517"><span>Edit the temporary table on the <strong id="EN-US_TOPIC_0000001860318829__b19662193213510">Result</strong> tab. You can click to add, delete, modify, or cancel modifications to edit the temporary table.</span><p><p id="EN-US_TOPIC_0000001860318829__p391013294113"><span><img id="EN-US_TOPIC_0000001860318829__image49291326616" src="figure/en-us_image_0000001860319153.png" width="492.1" height="129.6484" title="Click to enlarge" class="imgResize"></span></p>
+<p id="EN-US_TOPIC_0000001860318829__p16926175118281"></p>
+</p></li></ol>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="DWS_DS_016.html">Table Management</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/dws/tool/DWS_DS_021.html

@@ -0,0 +1,14 @@
+<a name="EN-US_TOPIC_0000001813598992"></a><a name="EN-US_TOPIC_0000001813598992"></a>
+
+<h1 class="topictitle1">Creating a Foreign Table</h1>
+<div id="body1584526252526"><div class="notice" id="EN-US_TOPIC_0000001813598992__note1932316691012"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="EN-US_TOPIC_0000001813598992__p1232317691012">Currently, Data Studio does not support foreign table creation. You can only view foreign tables.</p>
+</div></div>
+<p id="EN-US_TOPIC_0000001813598992__en-us_topic_0185264388_p101155499129">Foreign tables created using query execution in <strong id="EN-US_TOPIC_0000001813598992__b10860174714449">SQL Terminal</strong> or any other tool can be viewed in the <strong id="EN-US_TOPIC_0000001813598992__b9860134710446">Object</strong> browser after refresh.</p>
+<p id="EN-US_TOPIC_0000001813598992__p5456104861116">Right-click the database, schema, or foreign table group and choose <strong id="EN-US_TOPIC_0000001813598992__b21091982460">Refresh</strong> from the shortcut menu to view the created foreign table.</p>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="DWS_DS_016.html">Table Management</a></div>
+</div>
+</div>
+

docs/dws/tool/DWS_DS_023.html

@@ -0,0 +1,41 @@
+<a name="EN-US_TOPIC_0000001860198753"></a><a name="EN-US_TOPIC_0000001860198753"></a>
+
+<h1 class="topictitle1">Sequence Management</h1>
+<div id="body1584526252528"><div class="section" id="EN-US_TOPIC_0000001860198753__section13475528329"><h4 class="sectiontitle">Creating a Sequence</h4><ol id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_ol39613592028"><li id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_li185623420712"><span>In the <strong id="EN-US_TOPIC_0000001860198753__b777220242044">Object Browser</strong> pane, right-click <strong id="EN-US_TOPIC_0000001860198753__b55561740646">Sequences</strong> under the particular schema where you want to create the sequence and select <strong id="EN-US_TOPIC_0000001860198753__b028245412417">Create Sequence</strong>. The <strong id="EN-US_TOPIC_0000001860198753__b10931526650">Create New Sequence</strong> dialog box is displayed.</span><p><p id="EN-US_TOPIC_0000001860198753__p6624185112220"><span><img id="EN-US_TOPIC_0000001860198753__image18661615438" src="figure/en-us_image_0000001813599152.png"></span></p>
+<p id="EN-US_TOPIC_0000001860198753__p53391214144015"></p>
+</p></li><li id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_li20971059226"><span>Provide information to create a sequence:</span><p><ol type="a" id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_ol485234013913"><li id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_li1585212405910">Enter a name in the <strong id="EN-US_TOPIC_0000001860198753__b198100141568">Sequence Name</strong> field.</li></ol>
+<div class="note" id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_note9920142154518"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_p492114224516">Select the <strong id="EN-US_TOPIC_0000001860198753__b611695912611">Case</strong> check box to retain the capitalization of the text entered in <strong id="EN-US_TOPIC_0000001860198753__b8906172473">Sequence Name</strong> field. For example, if the entered sequence name is <strong id="EN-US_TOPIC_0000001860198753__b15587114176">Employee</strong>, then the sequence name is created as "Employee".</p>
+</div></div>
+<ol type="a" start="2" id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_ol13851124016919"><li id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_li118471740896">Enter the minimum value in the <strong id="EN-US_TOPIC_0000001860198753__b61085521815">Minimum Value</strong> field.</li><li id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_li13847940992">Enter the increase step value in the <strong id="EN-US_TOPIC_0000001860198753__b455615200915">Increment By</strong> field.</li><li id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_li20848640499">Enter maximum value in the <strong id="EN-US_TOPIC_0000001860198753__b555118391192">Maximum Value</strong> field.<div class="note" id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_note195896349106"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_p1459016344105">The maximum and minimum value should be between -9,223,372,036,854,775,808 and 9,223,372,036,854,775,807.</p>
+</div></div>
+</li><li id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_li48495409914">Enter the start value of the sequence in <strong id="EN-US_TOPIC_0000001860198753__b7151227171010">Start Value</strong> field.</li><li id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_li1784920409914">Enter the cache information in <strong id="EN-US_TOPIC_0000001860198753__b575014641012">Cache</strong> field. The cache value denotes the number of sequences stored in the memory for quick access.</li><li id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_li1885011409915">Select the <strong id="EN-US_TOPIC_0000001860198753__b595633013115">Cycle</strong> field to recycle sequences after the number of sequences reaches either the maximum or minimum value.<div class="note" id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_note168467550136"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_p158461455151319">The schema name auto-populates in the <strong id="EN-US_TOPIC_0000001860198753__b10367114910115">Schema</strong> field.</p>
+</div></div>
+</li><li id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_li585118402910">Select the table from the <strong id="EN-US_TOPIC_0000001860198753__b31073914129">Table</strong> drop-down list.</li><li id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_li1485111400915">Select the column from the <strong id="EN-US_TOPIC_0000001860198753__b16812173117124">Column</strong> drop-down list.</li></ol>
+</p></li><li id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_li165071542135019"><span>Click <strong id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_b14433102011482">Finish</strong>.</span><p><div class="p" id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_p89726217518">The status bar displays the status of the completed operation.<div class="note" id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_note112661910154915"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264927_p826721064910">On the <strong id="EN-US_TOPIC_0000001860198753__b1580193318188">SQL Preview</strong> tab, you can view the SQL query automatically generated for the inputs provided.</p>
+</div></div>
+</div>
+</p></li></ol>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001860198753__section16262725876"><h4 class="sectiontitle">Support for Sequence DDL</h4><p id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264735_p16885165644515">Data Studio allows you to display sequence DDL and export sequence DDL, including <strong id="EN-US_TOPIC_0000001860198753__b1457012139313">Show DDL</strong>, <strong id="EN-US_TOPIC_0000001860198753__b319114171336">Export DDL</strong>, and <strong id="EN-US_TOPIC_0000001860198753__b540511251633">Export DDL and Data</strong>.</p>
+<p id="EN-US_TOPIC_0000001860198753__p750903111815">In the <strong id="EN-US_TOPIC_0000001860198753__b15588175985519">Object Browser</strong> pane, right-click the selected table.</p>
+<p id="EN-US_TOPIC_0000001860198753__p18597163320810">To check DDL statement, choose <strong id="EN-US_TOPIC_0000001860198753__b1725913198569">Show DDL</strong>.</p>
+<p id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264735_p9939192171511">To export DDL statements, choose <strong id="EN-US_TOPIC_0000001860198753__b10302154005616">Export DDL</strong>.</p>
+<p id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264735_p11939142151510">To export DDL and SELECT statements, choose <strong id="EN-US_TOPIC_0000001860198753__b1283820165714">Export DDL and Data</strong></p>
+<p id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264735_p939154181613">The procedure is shown in the following figure.</p>
+<p id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264735_p14148314155213"><span><img id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264735_image3147131475220" src="figure/en-us_image_0000001813439364.png"></span></p>
+<p id="EN-US_TOPIC_0000001860198753__p1422205254416"></p>
+<div class="note" id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264735_note1880132922017"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001860198753__en-us_topic_0185264735_p17816294201">Only the sequence owner, system administrator, or a user who has the select permission on the sequence can perform the preceding operations.</p>
+</div></div>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001860198753__section47211761196"><h4 class="sectiontitle">Granting/Revoking a Privilege</h4><ol id="EN-US_TOPIC_0000001860198753__ol1992165919"><li id="EN-US_TOPIC_0000001860198753__li12951610913"><span>Right-click selected sequence and select <strong id="EN-US_TOPIC_0000001860198753__b497404872212">Grant/Revoke</strong>. The <strong id="EN-US_TOPIC_0000001860198753__b1490167910">Grant/Revoke</strong> dialog box is displayed.</span></li><li id="EN-US_TOPIC_0000001860198753__li12915161912"><span>Select the objects to grant/revoke privilege from the <strong id="EN-US_TOPIC_0000001860198753__b45699525581225">Object Selection</strong> tab and click <strong id="EN-US_TOPIC_0000001860198753__b207840308481225">Next</strong>.</span></li><li id="EN-US_TOPIC_0000001860198753__li131014161391"><span>Select the <strong id="EN-US_TOPIC_0000001860198753__b1623720571227">role</strong> from the Role drop-down list in the <strong id="EN-US_TOPIC_0000001860198753__b1523711578227">Privilege Selection</strong> tab. Select <strong id="EN-US_TOPIC_0000001860198753__b202371157142215">Grant/Revoke</strong> in the <strong id="EN-US_TOPIC_0000001860198753__b192381557172216">Privilege Selection</strong> tab.</span></li><li id="EN-US_TOPIC_0000001860198753__li91010162916"><span>On the <strong id="EN-US_TOPIC_0000001860198753__b2331472315">SQL Preview</strong> tab, you can check the automatically generated SQL query.</span></li><li id="EN-US_TOPIC_0000001860198753__li1119167912"><span>Click <strong id="EN-US_TOPIC_0000001860198753__b101116164912">Finish</strong>.</span></li></ol>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001860198753__section20424139111016"><h4 class="sectiontitle">Dropping a Sequence</h4><p id="EN-US_TOPIC_0000001860198753__p9390172385110">Right-click the selected sequence and select <strong id="EN-US_TOPIC_0000001860198753__b208057772413">Drop Sequence</strong>. The <strong id="EN-US_TOPIC_0000001860198753__b1849617272243">Drop Sequence</strong> dialog box is displayed. Click <strong id="EN-US_TOPIC_0000001860198753__b741614548242">Yes</strong> to drop the sequence.</p>
+<p id="EN-US_TOPIC_0000001860198753__p11837453516">Right-click the selected sequence and select <strong id="EN-US_TOPIC_0000001860198753__b131625243255">Drop Sequence Cascade</strong>.</p>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="DWS_DS_012.html">Database Management</a></div>
+</div>
+</div>
+

docs/dws/tool/DWS_DS_024.html

@@ -0,0 +1,32 @@
+<a name="EN-US_TOPIC_0000001813598668"></a><a name="EN-US_TOPIC_0000001813598668"></a>
+
+<h1 class="topictitle1">Users/Roles</h1>
+<div id="body1584526252529"><div class="section" id="EN-US_TOPIC_0000001813598668__section5783182373617"><h4 class="sectiontitle">Creating a User/Role</h4><p id="EN-US_TOPIC_0000001813598668__en-us_topic_0185264337_p158414053416">A database is used by many users, and the users are grouped for management convenience. A database role represents a database user or a group of database users.</p>
+<p id="EN-US_TOPIC_0000001813598668__en-us_topic_0185264337_p65702525297">Users and roles have similar concepts in databases. In practice, you are advised to use a role to manage permissions rather than to access databases.</p>
+<ul id="EN-US_TOPIC_0000001813598668__ul125888196539"><li id="EN-US_TOPIC_0000001813598668__li85881919155319"><strong id="EN-US_TOPIC_0000001813598668__b10165182119375">Users</strong>: They are set of database users. These users are different from operating system users. These users can assign permissions to other users to access database objects.</li><li id="EN-US_TOPIC_0000001813598668__li1758871945315"><strong id="EN-US_TOPIC_0000001813598668__b59311222143720">Role</strong>: This can be considered as a user or group based on the usage. Roles are at cluster level, and hence applicable to all databases in the cluster. A role is a cluster-level definition and applies to all databases in a cluster.</li></ul>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598668__section2647133113718"><h4 class="sectiontitle">Dropping a User/Role</h4><p id="EN-US_TOPIC_0000001813598668__p1218572117381">Right-click the selected user/role and select <strong id="EN-US_TOPIC_0000001813598668__b919317915381">Drop User/Role</strong>.</p>
+<p id="EN-US_TOPIC_0000001813598668__p1464713320377"><span><img id="EN-US_TOPIC_0000001813598668__image1474019171397" src="figure/en-us_image_0000001813599128.png"></span></p>
+<p id="EN-US_TOPIC_0000001813598668__p1364783353718"></p>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598668__section1482154623720"><h4 class="sectiontitle">Viewing/Editing User/Role Properties</h4><p id="EN-US_TOPIC_0000001813598668__p156391962116">Right-click the selected user/role and select <strong id="EN-US_TOPIC_0000001813598668__b19723534104011">Properties</strong>.</p>
+<p id="EN-US_TOPIC_0000001813598668__p482184619375">Data Studio displays the properties (General, Privilege, and Membership) of the selected user/role in different tabs. Editing of properties can be performed. OID is a non-editable field.</p>
+<p id="EN-US_TOPIC_0000001813598668__p8292151910131"><span><img id="EN-US_TOPIC_0000001813598668__image208616229155" src="figure/en-us_image_0000001860319045.png" width="492.1" height="136.5777" title="Click to enlarge" class="imgResize"></span></p>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598668__section10263757193713"><h4 class="sectiontitle">Viewing the User/Role DDL</h4><p id="EN-US_TOPIC_0000001813598668__p1926581851619">Right-click the selected user/role and select <strong id="EN-US_TOPIC_0000001813598668__b69132049164113">Show DDL</strong>.</p>
+<p id="EN-US_TOPIC_0000001813598668__p12627576373">The user/role DDL is displayed in a new <strong id="EN-US_TOPIC_0000001813598668__b627182794217">SQL Terminal</strong> tab. You must refresh the <strong id="EN-US_TOPIC_0000001813598668__b18720151317421">Object Browser</strong> to view the latest DDL.</p>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="DWS_DS_012.html">Database Management</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/dws/tool/DWS_DS_025.html

@@ -0,0 +1,37 @@
+<a name="EN-US_TOPIC_0000001813598884"></a><a name="EN-US_TOPIC_0000001813598884"></a>
+
+<h1 class="topictitle1">SQL Terminal Management</h1>
+<div id="body1584526252529"></div>
+<div>
+<ul class="ullinks">
+<li class="ulchildlink"><strong><a href="DWS_DS_026.html">Opening Multiple SQL Terminal Tabs</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_027.html">Managing the SQL Query Execution History</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_028.html">Opening and Saving SQL Scripts</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_029.html">Viewing Table Properties, PL/SQL Functions/Procedures on the SQL Terminal Page</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_030.html">Terminating an Ongoing SQL Query</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_031.html">Formatting of SQL Queries</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_032.html">Selecting a DB Object in the SQL Terminal</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_033.html">Viewing the Execution Plan and Costs</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_034.html">Viewing the Query Execution Plan and Cost Graphically</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_035.html">Working with SQL Terminals</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_036.html">Exporting Query Results</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="DWS_DS_037.html">Managing Connections in the SQL Terminal</a></strong><br>
+</li>
+</ul>
+
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_ds_index.html">Data Studio</a></div>
+</div>
+</div>
+

docs/dws/tool/DWS_DS_027.html

@@ -0,0 +1,64 @@
+<a name="EN-US_TOPIC_0000001813598768"></a><a name="EN-US_TOPIC_0000001813598768"></a>
+
+<h1 class="topictitle1">Managing the SQL Query Execution History</h1>
+<div id="body1584526252529"><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p35191048">Data Studio allows viewing and managing frequently used SQL queries. The history of executed SQL queries is maintained only for the <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b2905617223547">SQL Terminal</strong>.</p>
+<ol id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ol320174758"><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li16362779511"><span>On the <strong id="EN-US_TOPIC_0000001813598768__b20143134112313">SQL Terminal</strong> tab page, click <strong id="EN-US_TOPIC_0000001813598768__b337110436231">SQL History.</strong> The <strong id="EN-US_TOPIC_0000001813598768__b9696102922310">SQL History</strong> dialog box is displayed.</span><p><p id="EN-US_TOPIC_0000001813598768__p138902598320"><span><img id="EN-US_TOPIC_0000001813598768__image1260013311956" src="figure/en-us_image_0000001813599184.png" width="492.1" height="80.8108" title="Click to enlarge" class="imgResize"></span></p>
+<p id="EN-US_TOPIC_0000001813598768__p1623843011146"></p>
+</p></li></ol>
+<div class="note" id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_note33979931"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p39948792">SQL history scripts are not encrypted.</p>
+</div></div>
+<p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p37383929">The number of queries saved in the <strong id="EN-US_TOPIC_0000001813598768__b620935313498">SQL History</strong> dialog box is based on the value defined in <strong id="EN-US_TOPIC_0000001813598768__b120985374913">Preferences &gt; Editor &gt; SQL </strong><strong id="EN-US_TOPIC_0000001813598768__b7209105344917">History</strong> pane. Refer to the <a href="DWS_DS_005.html#EN-US_TOPIC_0000001813438860__table1510418570339">Table 1</a> section to modify the SQL History count. Data Studio overwrites the older queries into the SQL history after the list is full. The executed query is automatically stored in the list.</p>
+<p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p32432801134124">The <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b3867312518611">SQL History</strong> dialog box has the following columns:</p>
+<ul id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ul911047"><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li43916760"><strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b4586012918114">Pin Status</strong> - Displays the pinned status of the queries. Pinned queries will always show on the top and it will not be deleted from the history even when the list is full.</li><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li487831"><strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b21932360181111">SQL Statement</strong> - Displays the SQL query. The number of characters for an SQL query displayed in the <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b1570817018853">SQL Statement</strong> column is based on the number defined in <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b98019566214">Preferences &gt; Editor &gt; SQL </strong><strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b4802105610215">History</strong> pane. Refer to the <a href="DWS_DS_005.html#EN-US_TOPIC_0000001813438860__table1510418570339">Table 1</a> section to modify the number of characters for a query.</li><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li39514346"><strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b41299017181117">Number of Records</strong> - Displays the number of records fetched by the SQL query.</li><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li46545466"><strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b13184781181324">Start Time</strong> - Displays the time the query execution was started.</li><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li12086382"><strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b57484040181330">Execution Time</strong> - Displays the time taken to execute the query.</li><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li39472879"><strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b2552962181616">Database Name</strong> - Displays the name of the database.</li><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li43186596"><strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b4091068181338">Execution Status</strong> - Displays the execution status of the query as <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b42517832181021">Success</strong> or <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b21392392181021">Failure</strong>.</li></ul>
+<p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p8199431">Deleting the connection profile deletes the history. If the <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b611426323023">SQL History</strong> dialog box is closed, the query is not removed from the list.</p>
+<p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p4696429">You can perform the following operations in the <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b467110890557">SQL History</strong> dialog box:</p>
+<ul id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ul42267867"><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li619814411328"><a href="#EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ref471314809">Loading an SQL Query Into the SQL Terminal</a></li><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li4297671511342"><a href="#EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_section29561677225829">Loading Multiple SQL Queries Into the SQL Terminal</a></li><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li587321941141"><a href="#EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_section41363205225852">Deleting an SQL Query</a></li><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li1734002611414"><a href="#EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_section3787436422590">Deleting all SQL Queries</a></li><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li4695545211423"><a href="#EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ref471314785">Pinning an SQL Query</a></li><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li6023740211431"><a href="#EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_section62690964225923">Unpinning an SQL Query</a></li></ul>
+<div class="section" id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ref471314809"><a name="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ref471314809"></a><a name="en-us_topic_0185264358_ref471314809"></a><h4 class="sectiontitle">Loading an SQL Query Into the SQL Terminal</h4><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p29602433">Follow the steps to load the SQL query into the SQL terminal:</p>
+<ol id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ol48986840"><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li38228382"><span>Select the required query and click <span><img id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_image257215750433" src="figure/en-us_image_0000001860319669.jpg" height="24.9375" width="22.942500000000003" title="Click to enlarge" class="imgResize"></span>.</span><p><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p9491260">The query is appended to the cursor position in the <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b2309203604341">SQL Terminal</strong>.</p>
+</p></li></ol>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_section29561677225829"><a name="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_section29561677225829"></a><a name="en-us_topic_0185264358_section29561677225829"></a><h4 class="sectiontitle">Loading Multiple SQL Queries Into the SQL Terminal</h4><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p6915674">The <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b1857705004812">Load in SQL</strong> <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b14240444154012">Terminal and close History</strong> button loads selected queries into the <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b521702904145">SQL Terminal</strong> and closes the <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b6612224904215">SQL History</strong> dialog box.</p>
+<p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p8149778">Follow the steps to load selected SQL queries into the SQL terminal:</p>
+<ol id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ol56152285"><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li35608518"><span>Select the required queries.</span></li><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li52041212"><span>Click <span><img id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_image4769516904921" src="figure/en-us_image_0000001813599736.jpg" height="20.9475" width="20.9475" title="Click to enlarge" class="imgResize"></span>.</span><p><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p54588632">The queries are appended to the cursor position in the <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b511614260490">SQL Terminal</strong>.</p>
+</p></li></ol>
+<div class="note" id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_note6922452132615"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p1315255491312">If you continue the execution on error, then each statement in the terminal will be running as a scheduled job and runs one after the other. The execution status is updated on the console and job progress is displayed. When the time difference between Job Execution, Progress Bar Update and Console Update is very minimal, you will not be able to open the progress bar and stop the execution. In such scenarios you have to close the SQL terminal to the terminate execution.</p>
+</div></div>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_section132578461665"><h4 class="sectiontitle">Loading More Records</h4><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p117083321084">Regarding to load more data of result tab, you have to scroll down to bottom in order to load more data, which is inconvenient in some use cases. Currently, DS supports a loading more record button which makes it easier to trigger the loading more data action.</p>
+<p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p11121122718117">Follow the steps to load more records</p>
+<ol id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ol12211450131519"><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li942519214815"><span>Select the required queries and click <span><img id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_image122211313282" src="figure/en-us_image_0000001813439396.png"></span>.</span><p><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p144010144274">List all the required records.</p>
+</p></li></ol>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_section41363205225852"><a name="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_section41363205225852"></a><a name="en-us_topic_0185264358_section41363205225852"></a><h4 class="sectiontitle">Deleting an SQL Query</h4><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p66665241">Follow the steps to delete a SQL query from the SQL history list:</p>
+<ol id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ol31175435"><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li12143461"><span>Select the required query and click <span><img id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_image3293713805028" src="figure/en-us_image_0000001813599732.jpg" height="23.94" width="18.9525" title="Click to enlarge" class="imgResize"></span>.</span><p><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p44096323">A confirmation pop up window is displayed.</p>
+</p></li><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li61322592"><span>Click <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b30641655154726">OK</strong>.</span></li></ol>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_section3787436422590"><a name="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_section3787436422590"></a><a name="en-us_topic_0185264358_section3787436422590"></a><h4 class="sectiontitle">Deleting all SQL Queries</h4><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p9666612">Follow the steps to delete all SQL queries from the SQL History list:</p>
+<ol id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ol44798103"><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li529748"><span>Click <span><img id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_image4662572805130" src="figure/en-us_image_0000001860199813.jpg" height="23.94" width="20.9475" title="Click to enlarge" class="imgResize"></span>.</span><p><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p42909617">A confirmation pop up window is displayed.</p>
+</p></li><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li50642235"><span>Click <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b3573786154721">OK</strong>.</span></li></ol>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ref471314785"><a name="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ref471314785"></a><a name="en-us_topic_0185264358_ref471314785"></a><h4 class="sectiontitle">Pinning an SQL Query</h4><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p8314412">You can pin queries that you do not want Data Studio to delete automatically from the <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b5461759923814">SQL History</strong>. You can pin a maximum of 50 queries. Pinned queries are displayed at the top of the list. The value set in SQL history count does not affect the pinned queries. Refer to <a href="DWS_DS_005.html#EN-US_TOPIC_0000001813438860__table1510418570339">Table 1</a> for additional information on SQL history count.</p>
+<div class="note" id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_note2378778"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p21409010">The pinned queries appear on top once the <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b5618646916313_1">SQL History</strong> window is closed and re-opened.</p>
+</div></div>
+<p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p5668011">Follow the steps to pin a SQL query:</p>
+<ol id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ol51012105"><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li56455762"><span>Select the required SQL query and click <span><img id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_image5678459021288" src="figure/en-us_image_0000001813439956.jpg" height="17.955000000000002" width="18.9525" title="Click to enlarge" class="imgResize"></span>.</span><p><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p9514038">The <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b368082305310">Pin Status</strong> column displays the pinned status of the query.</p>
+</p></li></ol>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_section62690964225923"><a name="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_section62690964225923"></a><a name="en-us_topic_0185264358_section62690964225923"></a><h4 class="sectiontitle">Unpinning an SQL Query</h4><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p23521075">Follow the steps to unpin a SQL query:</p>
+<ol id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_ol10363091"><li id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_li26158957"><span>Select the required SQL query and click <span><img id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_image48456866212823" src="figure/en-us_image_0000001813439952.jpg" height="17.955000000000002" width="18.9525" title="Click to enlarge" class="imgResize"></span>.</span><p><p id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_p38500800">The <strong id="EN-US_TOPIC_0000001813598768__en-us_topic_0185264358_b2760088705316">Pin Status</strong> column displays the unpinned status of the query.</p>
+</p></li></ol>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="DWS_DS_025.html">SQL Terminal Management</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/dws/tool/DWS_DS_028.html

@@ -0,0 +1,38 @@
+<a name="EN-US_TOPIC_0000001860198725"></a><a name="EN-US_TOPIC_0000001860198725"></a>
+
+<h1 class="topictitle1">Opening and Saving SQL Scripts</h1>
+<div id="body1584526252529"><div class="section" id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_section171361011182215"><h4 class="sectiontitle">Opening an SQL Script</h4><p id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_p3942429">Follow the steps to open an SQL script:</p>
+<ol id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_ol35481869"><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li1814025993618"><span>Choose <strong id="EN-US_TOPIC_0000001860198725__b1611993519258">File</strong> &gt; <strong id="EN-US_TOPIC_0000001860198725__b945583702511">Open</strong> from the main menu. Alternatively, click <strong id="EN-US_TOPIC_0000001860198725__b1016915262614">Open</strong> on the toolbar or right-click the <strong id="EN-US_TOPIC_0000001860198725__b1523214952613">SQL Terminal</strong> and select <strong id="EN-US_TOPIC_0000001860198725__b99511311182612">Open</strong>.</span><p><p id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_p17382100173719">If the SQL Terminal has existing content, then there will be an option to overwrite the existing content or append content to it.</p>
+</p></li><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li32875415369"><span>The Open dialog box is displayed.</span></li><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li2417790911166"><span>In <strong id="EN-US_TOPIC_0000001860198725__b15952183542818">Open</strong> dialog box, select the SQL file to import and click <strong id="EN-US_TOPIC_0000001860198725__b799524116282">Open</strong>.</span><p><p id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_p89511710163619">The selected SQL script is opened as a <strong id="EN-US_TOPIC_0000001860198725__b1383995922810">File Terminal</strong>.</p>
+<p id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_p110110490293">The icons on the file terminal tab are different from those on the <strong id="EN-US_TOPIC_0000001860198725__b17273457553">SQL terminal</strong> tab. When you move the mouse cursor over the source file, corresponding database connection will be displayed on <strong id="EN-US_TOPIC_0000001860198725__b193351951182913">File Terminal</strong>.</p>
+</p></li></ol>
+<div class="note" id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_note127611408320"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_ul95902419599"><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li1959015419591">The encoding type of the SQL file must match the encoding type specified in <a href="DWS_DS_005.html#EN-US_TOPIC_0000001813438860__table1510418570339">Table 1</a>.</li><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li85907410591">Label of the file terminal will start with asterisk(*) if any of its content is edited. Dirty flag is removed once the file terminal is saved.</li><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li76788246339">File Terminals cannot be renamed. One terminal is always mapped to one Source Script File, but one script can be opened in multiple terminals.</li><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li9130123418261">You can open SQL scripts only on SQL Terminals.</li></ul>
+</div></div>
+</div>
+<p id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_p179381431153513">Data Studio allows you to save and open SQL scripts in the SQL Terminal. After saving the changes, SQL Terminal will be changed to a File Terminal.</p>
+<div class="section" id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_section6440164084417"><h4 class="sectiontitle">Saving an SQL Script</h4><p id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_p17509173264212">The <strong id="EN-US_TOPIC_0000001860198725__b2221216173217">Save</strong> option saves the File Terminal content to the associated file.</p>
+<p id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_p46107371">Follow the steps to save an SQL script:</p>
+<ol id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_ol12313157"><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li168515402033"><span>Perform any of the following operations:</span><p><ul id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_ul1516835410916"><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li161681154393">Choose File &gt; Save from the main menu.</li><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li4168854099">Press "Ctrl + S" to save the SQL terminal content. (This operation can be performed to save the file terminal content.)</li><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li41699541197">Click <strong id="EN-US_TOPIC_0000001860198725__b10844323113311">Save</strong> on the toolbar or right-click the SQL Terminal and select <strong id="EN-US_TOPIC_0000001860198725__b1493392753312">Save</strong>.</li></ul>
+<p id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_p611811521236">The <strong id="EN-US_TOPIC_0000001860198725__b742101317339">Data Studio Security Disclaimer</strong> dialog box is displayed.</p>
+</p></li><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li15691113193117"><span>Click <strong id="EN-US_TOPIC_0000001860198725__b59111824163411">OK</strong>.</span><p><div class="p" id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_p6474161684819">Data Studio displays the status of the operation in the status bar.<div class="note" id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_note1550514155483"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_ul550571515481"><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li175058158487">The script is saved as an SQL file. Data Studio sets the read/write permission for the saved SQL file. To ensure security, you must set the read/write permissions for folders.</li><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li1950581511481">When a change is made in a file and if that associated file is unavailable, it will trigger the <strong id="EN-US_TOPIC_0000001860198725__b637312134357">Save As</strong> option.<ul id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_ul728517146557"><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li1510553175318">In any case, if saving of the source file is failed due to some reasons, then user is prompted with the <strong id="EN-US_TOPIC_0000001860198725__b23837551354">Save As</strong> option to save the content as a new source file. If you choose not to save (that is cancelling <strong id="EN-US_TOPIC_0000001860198725__b56119673613">Save As</strong>), then File Terminal gets converted into an SQL Terminal.</li><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li232216118208">The changes made to File Terminals are not <strong id="EN-US_TOPIC_0000001860198725__b15404172819364">Auto Saved</strong>.</li></ul>
+</li></ul>
+</div></div>
+</div>
+</p></li></ol>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_section1197648113310"><h4 class="sectiontitle">Saving an SQL Script in New File</h4><p id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_p137202513338">The<strong id="EN-US_TOPIC_0000001860198725__b65482052173616"> Save As</strong> option saves the terminal content to a new file.</p>
+</div>
+<p id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_p1993285913217">Follow the steps to save an SQL script:</p>
+<ol id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_ol8705141910340"><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li158971953219"><span>Perform any of the following operations:</span><p><ul id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_ul84816317220"><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li15481739223">Choose <strong id="EN-US_TOPIC_0000001860198725__b234632743711">File</strong> &gt; <strong id="EN-US_TOPIC_0000001860198725__b734732743714">Save as</strong>.</li><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li10489314227">Press Ctrl+Alt+S. (This operation supports saving SQL terminal contents and file terminal contents.)</li></ul>
+<p id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_p913794712236">The <strong id="EN-US_TOPIC_0000001860198725__b14432194617379">Data Studio Security Disclaimer</strong> dialog box is displayed.</p>
+</p></li><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li3556105515343"><span>Click <strong id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_b016511135155">OK</strong>.</span><p><p id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_p576012462508">The <strong id="EN-US_TOPIC_0000001860198725__b18430451382">Save As</strong> dialog box is displayed.</p>
+</p></li><li id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_li85989579223"><span>Select the location to save the script and click <strong id="EN-US_TOPIC_0000001860198725__b7892174111399">Save</strong>.</span></li></ol>
+<div class="note" id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_note135562400221"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001860198725__en-us_topic_0185264432_p3310135183216">When there are unsaved changes in File Terminals, user will be given an option to save or cancel on graceful exit of data studio.</p>
+</div></div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="DWS_DS_025.html">SQL Terminal Management</a></div>
+</div>
+</div>
+

docs/dws/tool/DWS_DS_029.html

@@ -0,0 +1,35 @@
+<a name="EN-US_TOPIC_0000001860318905"></a><a name="EN-US_TOPIC_0000001860318905"></a>
+
+<h1 class="topictitle1">Viewing Table Properties, PL/SQL Functions/Procedures on the SQL Terminal Page</h1>
+<div id="body1584526252529"><p id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_p30695458">You can view table properties and functions/procedures in Data Studio.</p>
+<p id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_p7823668">Perform the following steps to view table properties:</p>
+<ol id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_ol3304150"><li id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_li57570525"><span>Press <strong id="EN-US_TOPIC_0000001860318905__b9657132394115">Ctrl</strong> and move the cursor over the table name.</span><p><p id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_p98691835105515"><span><img id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_image148691357557" src="figure/en-us_image_0000001860319129.jpg" height="96.75750000000001" width="523.6875" title="Click to enlarge" class="imgResize"></span></p>
+</p></li><li id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_li31533686"><span>Click the highlighted table name. The attributes of the selected table are displayed in Data Studio.</span><p><div class="note" id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_note25200320"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_p25476288">All table properties are read-only.</p>
+</div></div>
+</p></li></ol>
+<p id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_p29737353">To view a function or procedure, perform the following steps:</p>
+<ol id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_ol66309591"><li id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_li27960000"><span>Press <strong id="EN-US_TOPIC_0000001860318905__b3677183818417">Ctrl</strong> and move the cursor over the function or procedure name.</span><p><p id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_p160357105615"><span><img id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_image1460316715617" src="figure/en-us_image_0000001860199289.jpg"></span></p>
+</p></li><li id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_li37035725"><span>Click the highlighted function or procedure name. Data Studio displays the selected function or procedure on the <strong id="EN-US_TOPIC_0000001860318905__b4148143124117">PL/SQL Viewer</strong> page.</span></li></ol>
+<p id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_p10593122173417">Perform the following steps to check view properties:</p>
+<ol id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_ol45931322123414"><li id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_li3593132212345"><span>Press <strong id="EN-US_TOPIC_0000001860318905__b758044913412">Ctrl</strong> and move the cursor over the view name.</span></li><li id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_li059372293412"><span>Click the highlighted view name. Data Studio displays the properties of the selected view.</span></li></ol>
+<div class="section" id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_section059710483476"><h4 class="sectiontitle">Saving the File Before Closing Data Studio</h4><p id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_p8953111914484">Before you exit, Data Studio prompts you to save the editing on the terminal.</p>
+<p id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_p57006548158">Perform the following steps:</p>
+<ol id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_ol54871313142313"><li id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_li1548701313237"><span>Click <strong id="EN-US_TOPIC_0000001860318905__b1922918864213">Close</strong> and the <strong id="EN-US_TOPIC_0000001860318905__b16229158164212">Exit Application</strong> dialog box is displayed.</span></li><li id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_li1433612119423"><span>Click <strong id="EN-US_TOPIC_0000001860318905__b7950201111423">Graceful Exit</strong>.</span><p><p id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_p97281917131718">In the <strong id="EN-US_TOPIC_0000001860318905__b1097681464217">Saving File Terminal</strong> dialog box, select the file terminal to be saved.</p>
+</p></li><li id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_li1258993784314"><span>Select the file terminal to be saved.</span></li><li id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_li37141914184414"><span>Click <strong id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_b18711043181617">OK</strong>.</span></li></ol>
+</div>
+<div class="note" id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_note123971846113420"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001860318905__en-us_topic_0185264827_p63981465347">If you select <strong id="EN-US_TOPIC_0000001860318905__b575414214427">Force Exit</strong>, the <strong id="EN-US_TOPIC_0000001860318905__b20754192114212">Saving File Terminal</strong> dialog box will not be displayed.</p>
+</div></div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="DWS_DS_025.html">SQL Terminal Management</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/dws/tool/DWS_DS_030.html

@@ -0,0 +1,29 @@
+<a name="EN-US_TOPIC_0000001813439004"></a><a name="EN-US_TOPIC_0000001813439004"></a>
+
+<h1 class="topictitle1">Terminating an Ongoing SQL Query</h1>
+<div id="body1584526252529"><p id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_p9315740">You can terminate an ongoing SQL query on the <strong id="EN-US_TOPIC_0000001813439004__b92988124553">SQL Terminal</strong> tab page of Data Studio.</p>
+<p id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_p16732802">To terminate an ongoing SQL query, perform the following steps:</p>
+<ol id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_ol5451022114445"><li id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_li2082994214445"><span>Execute a SQL query on the <strong id="EN-US_TOPIC_0000001813439004__b165803375616">SQL Terminal</strong> tab page.</span></li><li id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_li2302354214454"><span>Click <span><img id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_image443093191450" src="figure/en-us_image_0000001860199265.jpg" width="23.94" height="23.94" title="Click to enlarge" class="imgResize"></span> or press <strong id="EN-US_TOPIC_0000001813439004__b85965688045019">Shift</strong>+<strong id="EN-US_TOPIC_0000001813439004__b192737696745019">Esc</strong>.</span><p><p id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_p2849279914524">You can also choose <strong id="EN-US_TOPIC_0000001813439004__b1817072585613">Run</strong> &gt; <strong id="EN-US_TOPIC_0000001813439004__b0170625175611">Cancel</strong>, or right-click in the code area and choose <strong id="EN-US_TOPIC_0000001813439004__b917114258562">Cancel</strong>, or click <strong id="EN-US_TOPIC_0000001813439004__b417122510560">Cancel</strong> on the <strong id="EN-US_TOPIC_0000001813439004__b1417192535616">Progress View</strong> tab page.</p>
+</p></li></ol>
+<p id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_p21666058164121">After you terminate an ongoing query, the SQL statement being executed is stopped.</p>
+<p id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_p11449343">Database changes made by the canceled query are rolled back and the following queries will not be executed.</p>
+<p id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_p35935224">A query cannot be canceled and the <strong id="EN-US_TOPIC_0000001813439004__b5866469577">Result</strong> tab displays the result when:</p>
+<ol id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_ol54981566"><li id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_li19880414">The query has been executed and the result is being generated.</li><li id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_li44706003">The result of the executed query is being transferred from the server to the Data Studio client.</li></ol>
+<p id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_p25072049">A query cannot be canceled when you are viewing the execution plan of a query. For details, see <a href="DWS_DS_033.html">Viewing the Execution Plan and Costs</a>.</p>
+<p id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_p24321850">The <strong id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_b1415722113182">Messages</strong> tab displays a message indicating that the query has been cancelled.</p>
+<div class="note" id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_note23912794"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="EN-US_TOPIC_0000001813439004__en-us_topic_0185265031_p50509875">The <strong id="EN-US_TOPIC_0000001813439004__b30473477245019">Cancel</strong> option is enabled only when a query is being executed.</p>
+</div></div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="DWS_DS_025.html">SQL Terminal Management</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/dws/tool/DWS_DS_032.html

@@ -0,0 +1,45 @@
+<a name="EN-US_TOPIC_0000001860318781"></a><a name="EN-US_TOPIC_0000001860318781"></a>
+
+<h1 class="topictitle1">Selecting a DB Object in the SQL Terminal</h1>
+<div id="body1584526252530"><p id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_p19553210">Data Studio suggests a list of possible schema names, table names and column names, and views in the SQL Terminal.</p>
+<p id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_p41761167">Follow the steps below to select a DB object:</p>
+<ol id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_ol40306186"><li id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_li24130231"><span>Press <strong id="EN-US_TOPIC_0000001860318781__b14728662998138">Ctrl</strong> and <strong id="EN-US_TOPIC_0000001860318781__b15114111918138">Space</strong> and enter the required parent DB object name. The DB objects list is refined as you continue typing the DB object name. The DB objects list displays all DB objects of the database connected to the SQL Terminal.</span><p><p id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_p71605212577"><span><img id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_image191598217577" src="figure/en-us_image_0000001860199285.jpg" width="399" height="257.470976" title="Click to enlarge" class="imgResize"></span></p>
+</p></li><li id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_li10644124"><span>To select the parent DB object, use the <strong id="EN-US_TOPIC_0000001860318781__b19728744144411">Up</strong> or <strong id="EN-US_TOPIC_0000001860318781__b1643447144413">Down</strong> arrow keys and press <strong id="EN-US_TOPIC_0000001860318781__b19169050114415">Enter</strong> on the keyboard, or double-click the parent DB object.</span></li><li id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_li28688252"><span>Press <strong id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_b56867678">.</strong> to list all child DB objects.</span><p><p id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_p61001017155716"><span><img id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_image3100141719575" src="figure/en-us_image_0000001860319125.jpg" height="231.04001900000003" width="399" title="Click to enlarge" class="imgResize"></span></p>
+</p></li><li id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_li50368676"><span>To select the child DB object, use the <strong id="EN-US_TOPIC_0000001860318781__b1029118312459">Up</strong> or <strong id="EN-US_TOPIC_0000001860318781__b188672033164518">Down</strong> arrow keys and press <strong id="EN-US_TOPIC_0000001860318781__b1086723613451">Enter</strong> on the keyboard, or double-click the child DB object.</span><p><p id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_p50664905">On selection, the child DB object will be appended to the parent DB object (with a period '.').</p>
+<div class="note" id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_note53330965"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_ul798811152118"><li class="text" id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_li3656632316">Auto-suggest also works on keywords, data types, schema names, table names, views, and table name aliases in the same way as shown above for all schema objects that you have access.<p class="text" id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_p1523103664317"><a name="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_li3656632316"></a><a name="en-us_topic_0185264718_li3656632316"></a>Following is a sample query with alias objects:</p>
+<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_screen162320369430"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
+<span class="normal">2</span>
+<span class="normal">3</span>
+<span class="normal">4</span>
+<span class="normal">5</span>
+<span class="normal">6</span>
+<span class="normal">7</span>
+<span class="normal">8</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span>
+<span class="w">  </span><span class="n">table_alias</span><span class="p">.</span><span class="o">&lt;</span><span class="n">auto</span><span class="o">-</span><span class="n">suggest</span><span class="o">&gt;</span>
+<span class="k">FROM</span><span class="w"> </span><span class="n">test</span><span class="p">.</span><span class="n">t1</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="n">table_alias</span>
+<span class="w">  </span><span class="k">WHERE</span>
+<span class="w">    </span><span class="n">table_alias</span><span class="p">.</span><span class="o">&lt;</span><span class="n">auto</span><span class="o">-</span><span class="n">suggest</span><span class="o">&gt;</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">5</span>
+<span class="k">GROUP</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="n">table_alias</span><span class="p">.</span><span class="o">&lt;</span><span class="n">auto</span><span class="o">-</span><span class="n">suggest</span><span class="o">&gt;</span>
+<span class="k">HAVING</span><span class="w"> </span><span class="n">table_alias</span><span class="p">.</span><span class="o">&lt;</span><span class="n">auto</span><span class="o">-</span><span class="n">suggest</span><span class="o">&gt;</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">5</span>
+<span class="k">ORDER</span><span class="w"> </span><span class="k">BY</span><span class="w"> </span><span class="k">table</span><span class="w"> </span><span class="k">alias</span><span class="p">.</span><span class="o">&lt;</span><span class="n">auto</span><span class="o">-</span><span class="n">suggest</span><span class="o">&gt;</span>
+</pre></div></td></tr></table></div>
+</div>
+</li><li class="text" id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_li7280126162110">A loading message may be displayed on the <strong id="EN-US_TOPIC_0000001860318781__b1614115385811">SQL Terminal</strong> in the following scenarios:<ul id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_ul1937917819582"><li id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_li238068135811">The object is not loaded due to the value mentioned in the <strong id="EN-US_TOPIC_0000001860318781__b10309511124719">Load Limit</strong> field. For details, see <a href="DWS_DS_005.html#EN-US_TOPIC_0000001813438860__table1510418570339">Table 1</a>.</li><li id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_li1538516855811">The objects that are already added to <strong id="EN-US_TOPIC_0000001860318781__b9724920588139">Exclude</strong> will not be loaded. For details, see <a href="DWS_DS_005.html#EN-US_TOPIC_0000001813438860__table1510418570339">Table 1</a>.</li><li id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_li19392881584">There is a delay in fetching the object from the server.</li></ul>
+</li><li id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_li1616619247196">If there are objects with the same name in different case, then auto-suggest will display child objects of both parent objects.<p id="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_p2583101083917"><a name="EN-US_TOPIC_0000001860318781__en-us_topic_0185264718_li1616619247196"></a><a name="en-us_topic_0185264718_li1616619247196"></a>Example: If there are two schemas with the name <strong id="EN-US_TOPIC_0000001860318781__b18842105845814">public</strong> and <strong id="EN-US_TOPIC_0000001860318781__b1984213585589">PUBLIC</strong>, then all child objects for both these schemas will be displayed.</p>
+</li></ul>
+</div></div>
+</p></li></ol>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="DWS_DS_025.html">SQL Terminal Management</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/dws/tool/DWS_DS_036.html

@@ -0,0 +1,35 @@
+<a name="EN-US_TOPIC_0000001860318913"></a><a name="EN-US_TOPIC_0000001860318913"></a>
+
+<h1 class="topictitle1">Exporting Query Results</h1>
+<div id="body1584526252530"><p id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_p46158236">You can export the results of an SQL query into a CSV, Text or Binary file.</p>
+<p id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_p12770940">This section contains the following topics:</p>
+<ul id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_ul1148072013358"><li id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_li1448022017354"><a href="#EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_section449445904115">Exporting all data</a></li><li id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_li45052783510"><a href="#EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_section1056892694218">Exporting Data On the Current Page</a></li></ul>
+<div class="section" id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_section449445904115"><a name="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_section449445904115"></a><a name="en-us_topic_0185264341_section449445904115"></a><h4 class="sectiontitle">Exporting all data</h4><p id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_p32083483">The following functions are disabled while the export operation is in progress:</p>
+<ul class="subitemlist" id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_ul20315896"><li id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_li48625339">Executing SQL queries in the <strong id="EN-US_TOPIC_0000001860318913__b9555171251114">SQL Terminal</strong></li></ul>
+<ul id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_ul46338367"><li id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_li14392122">Executing PL/SQL statements</li><li id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_li63595775113352">Debugging PL/SQL statements</li></ul>
+<p id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_p22874645">Follow the steps below to export all results:</p>
+<ol id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_ol4545214"><li id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_ole_link6"><span>Select the <strong id="EN-US_TOPIC_0000001860318913__b1140420193165">Result</strong> tab.</span></li><li id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_ole_link7"><span>Click <span><img id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_image18812163310101" src="figure/en-us_image_0000001813439432.jpg"></span>. The <strong id="EN-US_TOPIC_0000001860318913__b919982313402">Export ResultSet Data</strong> window appears.</span><p><div class="p" id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_p1551204102419">Refer to <a href="DWS_DS_98.html#EN-US_TOPIC_0000001860318649__section32742219385">Exporting Table Data</a> to complete the export operation.<div class="note" id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_note3983054182214"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_p79821954152214">You can check the status bar to view the status of the result being exported.</p>
+</div></div>
+</div>
+<p id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_p2926649112616">The <strong id="EN-US_TOPIC_0000001860318913__b1570964831710">Data Exported Successfully</strong> dialog box is displayed.</p>
+</p></li><li id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_li65538407113555"><span>Click <strong id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_b359512119458">OK</strong>. Data Studio displays the status of the operation in the <strong id="EN-US_TOPIC_0000001860318913__b09737515182">Messages</strong> tab.</span><p><div class="note" id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_note34711916262"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_p35781442202710">If the disk is full while exporting the results, then Data Studio displays an error in the Messages tab. In this case, clear the disk, re-establish the connection and export the result data.</p>
+</div></div>
+<p id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_p48598040">The Messages tab shows the <strong id="EN-US_TOPIC_0000001860318913__b161975302020">Execution Time</strong>, <strong id="EN-US_TOPIC_0000001860318913__b5334172132117">Total Result Records Fetched</strong>, and the path where the file is saved.</p>
+</p></li></ol>
+</div>
+<div class="section" id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_section1056892694218"><a name="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_section1056892694218"></a><a name="en-us_topic_0185264341_section1056892694218"></a><h4 class="sectiontitle">Exporting Data On the Current Page</h4><p id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_p23537029">It is recommended to export all results instead of exporting the current page. The <strong id="EN-US_TOPIC_0000001860318913__b156651136192216">Export Current Page to CSV</strong> function has been deleted.</p>
+<p id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_p10506676">Follow the steps below to export the current page:</p>
+<ol id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_ol27451222"><li id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_li45734414"><span>Select the <strong id="EN-US_TOPIC_0000001860318913__b1517664122410">Result</strong> tab.</span></li><li id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_ole_link10"><span>Click the <span><img id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_image1080513479108" src="figure/en-us_image_0000001860199293.jpg"></span> icon to export the current page.</span><p><p id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_p1149657649">The <strong id="EN-US_TOPIC_0000001860318913__b121029114393445">Data Studio Security Disclaimer</strong> dialog box is displayed.</p>
+</p></li><li id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_li29619832"><span>Click <strong id="EN-US_TOPIC_0000001860318913__b956864612413">OK</strong>.</span></li><li id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_li55558125"><span>Select the location to save the current page.</span><p><div class="note" id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_note35228179"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p class="text" id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_p48618163">You can check the status bar to view the status of the page being exported.</p>
+</div></div>
+</p></li><li id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_li34910290"><span>Click <span class="uicontrol" id="EN-US_TOPIC_0000001860318913__uicontrol154079714093445"><b>Save</b></span>. The <strong id="EN-US_TOPIC_0000001860318913__b1348115396307">Data Exported Successfully</strong> dialog box is displayed.</span></li><li id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_li15427143114435"><span>Click <strong id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_b74557482469">OK</strong>. Data Studio displays the status of the operation in the <strong id="EN-US_TOPIC_0000001860318913__b576675319">Messages</strong> tab.</span><p><div class="note" id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_note156495718451"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="EN-US_TOPIC_0000001860318913__en-us_topic_0185264341_p7651057204519">If the disk is full while exporting the results, then Data Studio displays an error in the Messages tab. In this case, clear the disk, re-establish the connection and export the result data.</p>
+</div></div>
+</p></li></ol>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="DWS_DS_025.html">SQL Terminal Management</a></div>
+</div>
+</div>
+