vania-janet/multiturn-rag-retrieval-data huggingface dataset:
Release notes for IBM Cloud® Databases for etcd 

Use these release notes to learn about the latest updates to IBM Cloud® Databases for etcd that are grouped by date or build number.



 23 May 2023 

Setting up disk alerts for disk utilization tutorial
: In this tutorial, you use the IBM Cloud API and the [IBM Cloud CLI](https://cloud.ibm.com/docs/cli?topic=cli-getting-started) to set up an alert that emails you whenever the disk utilization of your database exceeds 90%. This specific example creates an alert on a Databases for Elasticsearch deployment, but it is applicable to all the databases in the IBM Cloud Databases catalog. For more information, see [Setting up disk alerts for disk utilization](https://cloud.ibm.com/docs/databases-for-mysql?topic=messages-for-etcd_full-disk-util-alert-tutorial).





 19 October 2022 

Deploying and Connecting a Cloud Databases Instance Tutorial
: This tutorial guides you through the process of deploying a Cloud Databases instance and connecting it to a web front end by creating a webpage that allows visitors to input a word and its definition. These values are then stored in a database running on Cloud Databases. You install the database infrastructure by using Terraform and your web application uses the popular Express framework. The application can then be run locally, or by using Docker. For more information, see [Deploying and Connecting a Cloud Databases Instance](https://cloud.ibm.com/docs/databases-for-etcd?topic=cloud-databases-create-instance-tutorial).





 11 October 2022 

Protecting IBM Cloud® Databases for etcd resources with context-based restrictions
: Context-based restrictions (CBR) give account owners and administrators the ability to define and enforce access restrictions for IBM Cloud® resources based on the context of access requests. Access to Cloud Databases resources can be controlled with CBR and identity and access management (IAM) policies.
[checkbox](https://cloud.ibm.com/docs-content/v1/content/f16b1f78a92498247223b337bd9303c2758b9ba8/discovery-data/images/checkbox.png) Add a collection that connects to an external data source or contains uploaded files. [Creating collections](https://cloud.ibm.com/docs/discovery-data?topic=discovery-data-collections) 
 ![checkbox](https://cloud.ibm.com/docs-content/v1/content/f16b1f78a92498247223b337bd9303c2758b9ba8/discovery-data/images/checkbox.png) Use the built-in Content mining application to analyze your data. [Analyzing your data with the content mining application](https://cloud.ibm.com/docs/discovery-data?topic=discovery-data-contentminerapp) 







 Analyze contracts 

Accelerate the pace at which experts can analyze complex documents.

Only users of installed deployments (IBM Cloud Pak for Data) or Premium or Enterprise plan-managed deployments can create this type of project.

Zoom

![Shows the Contract Info tab for a contract document query result.](https://cloud.ibm.com/docs-content/v1/content/f16b1f78a92498247223b337bd9303c2758b9ba8/discovery-data/images/contract-search.png)

Figure 5. Analyzing contracts

If analyzing contracts is your goal, complete the steps that are listed in the following table.



Checklist for analyzing contracts

 Step Task Related information 

 ![checkbox](https://cloud.ibm.com/docs-content/v1/content/f16b1f78a92498247223b337bd9303c2758b9ba8/discovery-data/images/checkbox.png) Create a Document Retrieval for Contracts project.
v2 [Get project](https://cloud.ibm.com/apidocs/discovery-datagetproject)

GET {url}/v2/projects/{project_id}
* Submitting a query is similar between the two versions. In v2, you can query all of the collections in a project or you can limit the query to one or more collections by specifying a collection_ids parameter. For example, compare the following requests to query data:

v1 [Query](https://cloud.ibm.com/apidocs/discoveryquery) request

POST {url}/v1/environments/{environment_id}/collections/{collection_id}/query

Data that is submitted with the request:

{
"query": "text:IBM"
}

v2 [Query](https://cloud.ibm.com/apidocs/discovery-dataquery) request

POST {url}/v2/projects/{project_id}/query

Data that is submitted with the request:

{
"collection_ids": [
"{collection_id_1}",
"{collection_id_2}"
],
"query": "text:IBM"
}

You can optionally omit the collection_ids parameter to query across all of the collections in the project.
* The passage parameter for a query has a new per_document option that ranks the documents by document quality, and then returns the highest-ranked passages per document in a document_passages field for each document entry in the results list of the response. If false, ranks the passages from all of the documents by passage quality regardless of the document quality and returns them in a separate passages field in the response.
* When passages are returned for a query, you can also enable answer finding. When true, answer objects are returned as part of each passage in the query results. When find_answers and per_document are both set to true, the document search results and the passage search results within each document are reordered by using the answer confidences.
Databases <br><br> * [Hyper Protect DBaaS for MongoDB](https://cloud.ibm.com/docs/hyper-protect-dbaas-for-mongodb?topic=hyper-protect-dbaas-for-mongodb-api-setup)<br> * [Hyper Protect DBaaS for PostgreSQL](https://cloud.ibm.com/docs/hyper-protect-dbaas-for-postgresql?topic=hyper-protect-dbaas-for-postgresql-api-setup)<br><br><br> 







 Terraform for IBM Cloud 

[Terraform on IBM Cloud](https://cloud.ibm.com/docs/ibm-cloud-provider-for-terraform?topic=ibm-cloud-provider-for-terraform-about) enables predictable and consistent provisioning of IBM Cloud resources so that you can rapidly build IaC to deploy complex cloud environments. The following table contains links about the Terraform capabilities for each service in the reference architectures.



Table 3. Terraform information for services in reference architectures

 Category VPC reference architecture Satellite reference architecture Optional for both 

 Core <br><br> * [VPC infrastructure services](https://cloud.ibm.com/docs/vpc?topic=ibm-cloud-provider-for-terraform-getting-started)[9]<br><br><br> <br><br> * [Satellite](https://cloud.ibm.com/docs/openshift?topic=openshift-terraform-setup)<br><br><br>
Some users choose to encode the document type in the _id, for example, user:56, book:55. The last example shows with a 32-digit string (generated in your app) that is designed to sort in approximate date and time order. This method makes it easy to retrieve the latest documents from the database, without a secondary index.

IBM Cloudant takes your document _ids and stores them in an index (like the contents page of book). This primary index is in _id order and is used to allow IBM Cloudant to retrieve documents by their _id - thus behaving like a key-value store.

By careful design of your _id field, you can make it use the primary index to keep data together that makes sense in the primary index. This method makes it quicker to retrieve that data later. We saw that using time-sortable _ids means that data can be retrieved in approximate date and time order.

We see an example later when it comes to retrieving ranges of document IDs.

In conclusion, each document must have an _id field that is unique in the database. It can be auto-generated by IBM Cloudant, or can be supplied by your application, in which case you must take responsibility for the uniqueness of the _id field.

The _id field is the basis of the database's primary index, which, as we see later, can be used for key-value lookups and range queries.

That's the end of this part. The next part is called The rev token.







 The rev token video 

Learn how IBM Cloudant creates a revision token when you add, edit, or delete a document.



* The rev token video script

Welcome to the Introduction to IBM Cloudant course, an 17-part video series that gives you an overview of the IBM Cloudant database-as-a-service.

This video is part 4 - The rev token.

The second fundamental IBM Cloudant rule is that each document revision is given its own unique revision token. Let's find out what it means.

You never need to generate a revision token - one is created for you when you add, update, or delete a document that uses the API.

A revision token consists of two parts:
"status": "available",
"description": "this is a demo collection",
"created": "2015-08-24T18:42:25.324Z",
"updated": "2015-08-24T18:42:25.324Z",
"document_counts": {
"available": 1000,
"processing": 20,
"failed": 180
},
"disk_usage": {
"used_bytes": 895111
},
"training_status": {
"data_updated": "2017-02-10T14:18:22.786Z",
"total_examples": 54,
"sufficient_label_diversity": false,
"processing": false,
"minimum_examples_added": true,
"successfully_trained": "2017-02-08T14:18:22.786Z",
"available": true,
"notices": 13,
"minimum_queries_added": true
}
}
Show more
5. When the following fields in the previous step all return true, issue some sample queries to see if the service returns more relevant results:



* minimum_queries_added
* minimum_examples_added
* sufficient_label_diversity



If the relevance of your results does not improve, add more training queries until the results meet your requirements.



For additional training guidance, see [Relevancy training tips](https://cloud.ibm.com/docs/discovery?topic=discovery-relevancy-tips).





 Performing other training-data query operations 

You can administer and maintain training-data queries by using other API methods as described in the [API reference](https://cloud.ibm.com/apidocs/discovery):



* [List the training data for a collection](https://cloud.ibm.com/apidocs/discoverylist-training-data)
Pricing 

Our strategic partnership with [Elastic](https://www.elastic.co/about/) since January 2023 means that we are able to offer more and richer functionality, as well as world-class levels of support.

All Databases for Elasticsearch plans deploy as one highly available Elasticsearch cluster with three data members. Your data is replicated across members. Plans are priced based on the total amount of disk storage, RAM, dedicated cores, and backup storage that is allocated to deployments, prorated hourly. Databases for Elasticsearch deployments have a minimum of 5 GB of disk and 1 GB of RAM per data member.



 IBM Cloud® Databases for Elasticsearch Enterprise Plan 

Versions 7.17 (preferred) and 8.7 (preview) are the current supported versions of Databases for Elasticsearch Enterprise Plan. This plan includes functionality that is not available in our Standard Plan. These features were previously offered by Elastic as paid-for add-ons under the X-Pack label, such as [Role Based Access Control (RBAC)](https://www.elastic.co/guide/en/elasticsearch/reference/7.17/es-security-principles.htmlsecurity-create-appropriate-users) and [Index Lifecycle Management (ILM)](https://www.elastic.co/guide/en/elasticsearch/reference/7.17/index-lifecycle-management.html). Once deployed, Databases for Elasticsearch Enterprise Plan clusters make full use of other Elastic Stack components such as [Kibana](https://cloud.ibm.com/docs/databases-for-elasticsearch?topic=databases-for-elasticsearch-getting-startedkibana), [Logstash](https://www.elastic.co/logstash/), and [Beats](https://www.elastic.co/beats/).





 IBM Cloud® Databases for Elasticsearch Standard Plan 

Versions 7.9 and 7.10 are available on Cloud Databases under the Standard Plan, but will be End of Life (EOL) by 30 November 2023.
You can upload documents using the API or the Discovery tooling. You can also connect to several different data sources (including Box, Salesforce, SharePoint Online, SharePoint 2016, and IBM Cloud Object Storage), or do a web crawl. For details, see [Adding content](https://cloud.ibm.com/docs/discovery?topic=discovery-addcontent).





 What document types are supported for ingestion? 

Refer to [Supported document types and browsers](https://cloud.ibm.com/docs/discovery?topic=discovery-sdudoctypes) for a list of the available document types by plan.





 How do you use the Smart Document Understanding editor? 

The SDU editor functions are available in the Discovery tooling. Read [Using the Smart Document Understanding editor](https://cloud.ibm.com/docs/discovery?topic=discovery-sduannotate) to get started.





 How much does Discovery cost? 

Discovery has several options available. See [Discovery pricing plans](https://cloud.ibm.com/docs/discovery?topic=discovery-discovery-pricing-plans).





 How do I upgrade my existing Discovery plan? 

For information on resizing your plan from Lite to Advanced, or switching from one Advanced tier to another, see [Upgrading your plan](https://cloud.ibm.com/docs/discovery?topic=discovery-upgrading-your-plan).





 How do I create a stopwords list? 

Discovery applies a default list of stopwords for several languages at query time. However, you can define and upload a custom list of stopwords that override the default list. Discovery applies the appropriate default or custom stopword list to your private collections, based on the language specified for that collection. For more information, see [Defining Stopwords](https://cloud.ibm.com/docs/discovery?topic=discovery-query-conceptsstopwords).





 What is a query expansion list? 

Query expansion terms are usually synonyms, antonyms, or typical misspellings for common terms.
[Checkmark](https://cloud.ibm.com/docs-content/v1/content/6f3c07c34058f637b1c86044ca4f9b24214330a7/activity-tracker//images/checkmark-icon.svg) [Location-based events](https://cloud.ibm.com/docs/satellite?topic=satellite-at_events) 







 Database services 

The following table lists database services that send auditing events:



Table 5. List of database services

 Service CRN service name Activity Tracker hosted event search offering Events 

 [IBM® Cloudant® for IBM Cloud®](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-getting-started-with-cloudant) cloudantnosqldb ![Checkmark](https://cloud.ibm.com/docs-content/v1/content/6f3c07c34058f637b1c86044ca4f9b24214330a7/activity-tracker//images/checkmark-icon.svg) [Location-based events](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-at_events) 
 [IBM Cloud Hyper Protect DBaaS for MongoDB](https://cloud.ibm.com/docs/hyper-protect-dbaas-for-mongodb?topic=hyper-protect-dbaas-for-mongodb-gettingstarted) hyperp-dbaas-mongodb ![Checkmark](https://cloud.ibm.com/docs-content/v1/content/6f3c07c34058f637b1c86044ca4f9b24214330a7/activity-tracker//images/checkmark-icon.svg) [Location-based events](https://cloud.ibm.com/docs/hyper-protect-dbaas-for-mongodb?topic=hyper-protect-dbaas-for-mongodb-activity-tracker-events)
HEAD /{db} <br>[Cloudant](https://cloud.ibm.com/apidocs/cloudantheaddatabase), [CouchDB](https://docs.couchdb.org/en/latest/api/database/common.html?highlight=head--dbhead--db) Retrieve the HTTP headers that contain a minimal amount of information about the specified database. 
 GET /{db} <br>[Cloudant](https://cloud.ibm.com/apidocs/cloudantgetdatabaseinformation), [CouchDB](https://docs.couchdb.org/en/latest/api/database/common.html?highlight=head--dbget--db) Retrieve information about the specified database. 
 POST /{db} <br>[Cloudant](https://cloud.ibm.com/apidocs/cloudantpostdocument), [CouchDB](https://docs.couchdb.org/en/latest/api/database/common.html?highlight=head--dbpost--db) Create or modify a document in the specified database by using the supplied JSON document. 
 PUT /{db} <br>[Cloudant](https://cloud.ibm.com/apidocs/cloudantputdatabase), [CouchDB](https://docs.couchdb.org/en/latest/api/database/common.html?highlight=head--dbput--db) Create a database. <br>Database names must start with a lowercase letter and contain only the following characters: lowercase characters (a-z), digits (0-9), any of the characters _, $, (, ), +, -, and /. 
 DELETE /{db} <br>[Cloudant](https://cloud.ibm.com/apidocs/cloudantdeletedatabase), [CouchDB](https://docs.couchdb.org/en/latest/api/database/common.html?highlight=head--dbdelete--db) Delete the specified database, and all the documents and attachments contained within it.
To discover the earliest recovery point through the API, use the [point-in-time-recovery timestamp endpoint](https://cloud.ibm.com/apidocs/cloud-databases-api/cloud-databases-api-v5capability). For more information, see [Point-in-time Recovery (PITR)](https://cloud.ibm.com/docs/databases-for-mongodb?topic=databases-for-mongodb-pitr&interface=ui).





 19 October 2022 

Deploying and Connecting a Cloud Databases Instance Tutorial
: This tutorial guides you through the process of deploying a Cloud Databases instance and connecting it to a web front end by creating a webpage that allows visitors to input a word and its definition. These values are then stored in a database running on Cloud Databases. You install the database infrastructure by using Terraform and your web application uses the popular Express framework. The application can then be run locally, or by using Docker. For more information, see [Deploying and Connecting a Cloud Databases Instance](https://cloud.ibm.com/docs/databases-for-mongodb?topic=cloud-databases-create-instance-tutorial).





 11 October 2022 

Protecting IBM Cloud® Databases for MongoDB resources with context-based restrictions
: Context-based restrictions (CBR) give account owners and administrators the ability to define and enforce access restrictions for IBM Cloud® resources based on the context of access requests. Access to Cloud Databases resources can be controlled with CBR and identity and access management (IAM) policies. For more information, see [Protecting Cloud Databases resources with context-based restrictions](https://cloud.ibm.com/docs/databases-for-mongodb?topic=cloud-databases-cbr&interface=ui).





 22 June 2022 

Mapping Global COVID-19 cases with the Databases for MongoDB EE (Enterprise Edition) Analytics Add-On and Tableau tutorial published
[IBM Cloud® Databases for EnterpriseDB](https://cloud.ibm.com/docs/databases-for-enterprisedb?topic=databases-for-enterprisedb-getting-started) databases-for-enterprisedb-group [Location-based events](https://cloud.ibm.com/docs/databases-for-enterprisedb?topic=cloud-databases-activity-tracker) 
 [IBM Cloud® Databases for DataStax](https://cloud.ibm.com/docs/databases-for-cassandra?topic=databases-for-cassandra-getting-started) databases-for-cassandra-group [Location-based events](https://cloud.ibm.com/docs/databases-for-enterprisedb?topic=cloud-databases-activity-tracker) 
 [IBM Cloud® Databases for PostgreSQL](https://cloud.ibm.com/docs/databases-for-postgresql?topic=databases-for-postgresql-getting-started) databases-for-postgresql [Location-based events](https://cloud.ibm.com/docs/databases-for-postgresql?topic=databases-for-postgresql-activity-tracker) 
 [IBM Cloud Databases for Redis](https://cloud.ibm.com/docs/databases-for-redis?topic=databases-for-redis-getting-started) databases-for-redis-group [Location-based events](https://cloud.ibm.com/docs/databases-for-redis?topic=databases-for-redis-activity-tracker) 
 [IBM Cloud Databases for etcd](https://cloud.ibm.com/docs/databases-for-etcd?topic=databases-for-etcd-getting-started) databases-for-etcd-group [Location-based events](https://cloud.ibm.com/docs/databases-for-etcd?topic=databases-for-etcd-activity-tracker)
Getting Started 

With IBM Cloud Databases (ICD) enabled by IBM Cloud Satellite, you can deploy ICD instances into a Satellite location. (ICD) enabled by IBM Cloud Satellite currently supports the following ICD managed database services:



* [Databases for etcd](https://cloud.ibm.com/docs/databases-for-etcd)
* [Databases for PostgreSQL](https://cloud.ibm.com/docs/databases-for-postgresql)
* [Databases for Redis](https://cloud.ibm.com/docs/databases-for-redis)
* [Messages for RabbitMQ](https://cloud.ibm.com/docs/messages-for-rabbitmq)



After your Satellite location instance is deployed, ICD will install an ICD Satellite service cluster in your Satellite location into which your database instances will be deployed.

Your ICD service cluster can operate multiple database instances, even with different database types. For instance, you might operate a Databases for etcd and a Databases for PostgreSQL instance on the same service cluster.

The service cluster name is based on the first database instance, even if multiple instances exist. For example, if your service cluster has both a Databases for etcd and a Databases for PostgreSQL instance on the same service cluster, the name is based on your Databases for etcd instance.

ICD enabled by IBM Cloud Satellite supports Satellite locations on [Amazon Web Services (AWS)](https://cloud.ibm.com/docs/satellite?topic=satellite-aws) and [on-premises](https://cloud.ibm.com/docs/cloud-databases?topic=cloud-databases-satellite-on-prem).



 An Overview 

Zoom

![An Overview of ICD enabled by IBM Cloud Satellite](https://cloud.ibm.com/docs-content/v1/content/5561b38c6df9e8168523d143eaf64ab6acd7b600/cloud-databases/images/sat_on_icd.svg)

Image 1.
AnyDB - IBM Db2 

The SAP systems in a landscape have specific requirements for servers, operating systems, network setup, and supported storage.

Deploying SAP AnyDB on IBM Cloud is similar to deployments with infrastructure with on-premises data centers. You can use the information that is provided from SAP and the RDBMS providers.

To assist your project's planning phase, more design considerations are provided for SAP AnyDB - IBM Db2 with IBM Cloud® for SAP.



 Overview of IBM Db2 for SAP with IBM Cloud® 

Several unique capabilities and features are available with IBM Db2. All supported database features that are mentioned in [SAP Note 1555903 - DB6: Supported IBM Db2 Database Features](https://launchpad.support.sap.com//notes/1555903) are available with IBM Cloud, except for:



* The IBM Db2 pureScale Feature
* Support for integrated cluster managers for HADR or shared disk high-availability clusters.



Before you start deploying the IBM Db2 software, ensure that:



* Check all relevant IBM Db2 information and prerequisites
* Check all relevant SAP and IBM Db2 information and prerequisites (for example, SAP Notes); including versions and fix pack levels of IBM Db2 that are supported
* All required packages are installed for the relevant OS that you are using for IBM Db2





 Documentation of IBM Db2 for SAP 

A good place to start is the [SAP community page for IBM Db2](https://community.sap.com/topics/db2-for-linux-unix-windows).

IBM Db2 support on SAP-certified Cloud IaaS:



* [IBM Knowledge Center for Db2 - Support for Db2 on public clouds (BYOSL, SAP Notes, Reference blueprints)](https://www.ibm.com/support/knowledgecenter/en/SSEPGG_11.5.0/com.ibm.db2.luw.licensing.doc/doc/r_suprt_db2_pblik_clouds.html)



IBM Db2 versions and fix pack levels that are supported by SAP: