You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
You can see the deprecations for {{site.data.keyword.cloudantfull}} here.
19
19
20
+
## {{site.data.keyword.cloudant_short_notm}} instances will be limited to 200 dbs starting March 1st, 2025
21
+
{: #cloudant-database-size-limit}
22
+
23
+
Beginning on March 3rd, new Cloudant instances will have a limit on the number of databases created within that instance.
24
+
25
+
- Each Cloudant Standard instance will only be permitted a maximum of 200 databases at any time.
26
+
- Each Cloudant Lite instance will only be permitted a maximum of 20 databases at any time.
27
+
- The limit will NOT apply to any Cloudant instance created before March 3rd, 2025. These instances will continue to have no limit imposed.
28
+
29
+
Once the limit is reached, any attempt to create an additional database will elicit an `HTTP 403` response. A Cloudant instance's current database count can be found by using the `/_api/v2/user/current/databases` api call, and the number of databases permitted is available from the `/_api/v2/user/capacity/databases` endpoint.
30
+
31
+
If an application requires more than 200 databases in total, then it should be configured to store its data across multiple Cloudant instances or you can reach out to support and exceptions can be granted on a case-by-case basis.
Due to the end of the Cloud Foundry service, {{site.data.keyword.cloudant_short_notm}} instances that are created as Cloud Foundry service instances are being deprecated and must be migrated to an {{site.data.keyword.cloud_notm}} [resource group](/docs/account?topic=account-rgs&interface=ui){: external}.
194
-
195
-
Migration to a resource group provides the added capability to use [{{site.data.keyword.cloud_notm}} IAM](/docs/account?topic=account-iamoverview){: external} to control access. When migrating the Cloudant instance, you can choose which of your {{site.data.keyword.cloud_notm}} resource groups to migrate it to. For example, you might have one resource group for production and a different one for Dev/Test.
196
-
197
-
Standard Plan instances that are not migrated before 1 September 2023 will be migrated by IBM.
198
-
{: important}
199
-
200
-
Should IBM be required to migrate a Cloudant instance to a resource group, it will be migrated to the default resource group for the {{site.data.keyword.cloud_notm}} account. The assignment of the Cloudant instance to the default resource group cannot be changed later.
201
-
202
-
**Deadline for Lite plan instances has been extended from 1 August 2023 to 18 September 2023: Lite plan instances that are not migrated before 18 September 2023 will be disabled for 30 days and deleted on 18 October 2023.**
203
-
204
-
### How do I know if my instances use Cloud Foundry?
- To complete the migration, follow these [{{site.data.keyword.cloudant_short_notm}} instructions](/docs/account?topic=account-migrate#migrate_instances){: external}.
214
-
215
-
1. Open the **More actions** menu.
216
-
1. Select **Migrate to a resource group** to get started.
217
-
1. Select a resource group.
218
-
1. Click **Migrate** and the instance is migrated for you.
219
-
1. Since you can migrate only one instance at a time, you can continue migrating eligible instances after you migrate the first one.
220
-
221
-
**The data in the Cloudant instance is not involved in this migration.**
222
-
**There is no Cloudant service downtime as a result of this migration.**
Support for the {{site.data.keyword.cloudant_short_notm}} Geospatial capability ends on 31 January 2023. In many cases, existing applications fail if changes are not made to address the removal of this functionality before the end of support.
228
-
{: deprecated}
229
-
230
-
### What is {{site.data.keyword.cloudant_short_notm}} Geospatial?
231
-
{: #what-is-cloudant-geospatial-dep}
232
-
233
-
Data is stored as GeoJSON in the {{site.data.keyword.cloudant_short_notm}} database to describe point, line, polygon, multi-point, multi-line, and multi-polygon objects. Each object, as well as the geographic information, can have optional properties: Metadata about the object, which is returned in the search results.
234
-
235
-
Again, an index is defined as a JavaScript function, and then, queries can be used to ask questions of your collection of geographic features. For example, find me the nearest object to this point; find objects within this polygon; find objects along this path; or find objects that intersect with this object.
236
-
237
-
To summarize, {{site.data.keyword.cloudant_short_notm}} Geo is something unique to the {{site.data.keyword.cloudant_short_notm}} service and is used to perform advanced geospatial queries against your databases of GeoJSON objects. It cannot be combined with other index types. It is only of use to Geographic Information Systems or use-cases that have a purely geographic purpose.
238
-
239
-
### What is changing?
240
-
{: #what-is-changing-dep}
241
-
242
-
As of 1 February 2023, the following conditions apply:
243
-
- Users cannot query `/$DATABASE/_design/$DDOCS/_geo` endpoints. Requests to those endpoints return a `404 Not Found` response.
244
-
- Users can define indexes by using the `st_indexes` keyword in design documents, but those indexes are ignored by the service. This practice ensures that existing design documents can be updated, and replications that contain geospatial indexes do not fail. Existing Geo indexes are deleted, and customers are no longer billed for the space they consume.
245
-
- {{site.data.keyword.cloud}} support no longer answers questions or assists with issues that are related to the Geospatial feature of the {{site.data.keyword.cloudant_short_notm}} service.
246
-
{: important}
247
-
248
-
### Alternatives to geospatial
249
-
{: #alternatives-to-geospatial-dep}
250
-
251
-
Many simple geospatial queries can be done without using the Geospatial capability that was removed from the {{site.data.keyword.cloudant_short_notm}} service. These alternatives are described in this [{{site.data.keyword.cloudant_short_notm}} blog post](https://blog.cloudant.com/2022/06/28/Simple-Geospatial-Queries.html){: external}.
As of 1 October 2023, {{site.data.keyword.cloudant_short_notm}}'s dbcopy feature (also known as "Chained MapReduce" or "view chaining") will cease to function. The dbcopy feature was [removed from our documentation in 2016](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-classic-release-notes#cloudant-feb16) and [since November 2022, new users cannot configure dbcopy](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-classic-release-notes#cloudant-nov22). *Starting 1 October 2023, the dbcopy feature will be removed from the {{site.data.keyword.cloudant_short_notm}} service entirely.*
257
-
{: shortdesc}
258
-
259
-
### What is dbcopy?
260
-
{: #what-is-dbcopy-dep}
261
-
262
-
{{site.data.keyword.cloudant_short_notm}} allows materialized MapReduce views to be created on a database - a secondary index structure that contains user-defined keys and values. MapReduce views exist and are queried in the same path as the primary database.
263
-
264
-
With the "dbcopy" feature configured, the MapReduce data is instead written to a second database. The second database then contains the key/value pairs that would usually be found in the materialized view of a normal MapReduce view. The dbcopy feature was used to allow view data to be "chained" (for example, the creation of views of views) or to provide a primitive *join* functionality between documents.
265
-
266
-
### What happens after the feature is removed?
267
-
{: #what-happens-after-removal-dep}
268
-
269
-
The primary database continues to function as normal, but any MapReduce indexes with dbcopy configured no longer write data to the secondary database. The secondary database still exists, but it cannot be updated when the primary data changes.
270
-
271
-
### How do I know whether my MapReduce views use dbcopy?
272
-
{: #how-do-i-know-if-mapreduce-uses-dbcopy-dep}
273
-
274
-
MapReduce index definitions are stored in a database's [design documents](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-design-documents). These MapReduce index definitions contain JavaScript that programmatically decides what data from the document makes it into the view, as shown in the following example:
If a view definition contains an attribute that is called `dbcopy`, as is the case with the previous example design document, then the dbcopy feature **is in use and is affected by the feature's removal**.
290
-
291
-
### Alternatives to dbcopy
292
-
{: #alternatives-to-dbcopy-dep}
293
-
294
-
No alternative to the dbcopy feature exists. Simply removing the "dbcopy" attribute from a design document instructs {{site.data.keyword.cloudant_short_notm}} to build a normal MapReduce view. This view contains the same data that was being copied to the secondary database, for example:
The dbcopy key was removed, so this view becomes a normal MapReduce view that you can [query by using the {{site.data.keyword.cloudant_short_notm}} API](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-using-views#querying-a-view).
309
-
{: note}
310
-
311
-
If you are concerned about the removal of the dbcopy feature, you can open a support ticket and ask to consult with our Client Architecture team.
312
-
313
-
## {{site.data.keyword.cloudant_short_notm}} Replications no longer support HTTP
314
-
{: #replications-no-longer-support-http}
315
-
316
-
As of 1 October 2023, the replicator for {{site.data.keyword.cloudant_short_notm}} no longer supports the HTTP protocol – it supports only the HTTPS protocol to ensure that customer data is always encrypted in flight.
317
-
318
-
These changes only affect replications leaving {{site.data.keyword.cloudant_short_notm}}. Customers who only replicate between Cloudant instances have no action to take.
319
-
{: important}
320
-
321
-
### What is replication?
322
-
{: #what-is-replication}
323
-
324
-
{{site.data.keyword.cloudant_short_notm}} replications allow you to copy one database's changes to another {{site.data.keyword.cloudant_short_notm}} database. This database is in the same {{site.data.keyword.cloudant_short_notm}} instance or in another {{site.data.keyword.cloudant_short_notm}} instance on the other side of the world. {{site.data.keyword.cloudant_short_notm}} also replicates to and from Apache CouchDB and PouchDB databases on the public internet.
325
-
326
-
### What happens after HTTP support is removed?
327
-
{: #after-http-support-is-removed}
328
-
329
-
Following this change, a replication that is configured with the `http://` protocol fails permanently. The replication job is not retried. Any replications using the `https://` protocol are unaffected.
330
-
331
-
### How do I know whether my replications use HTTP?
332
-
{: #how-do-i-check-my-http-use}
333
-
334
-
Replication job definitions are stored in documents in an {{site.data.keyword.cloudant_short_notm}} account's `_replicator` database, for example:
If either the `source` or `target` URLs contain an `http://` prefix, then **the replication job is affected** and action must be taken to ensure the replication runs.
346
-
347
-
### How do I avoid being affected?
348
-
{: #how-can-i-avoid-being-affected}
349
-
350
-
If a self-hosted CouchDB service supports HTTPS, then change the replication definition to contain an `https://` prefix, as shown in the following example:
{{site.data.keyword.cloudant_short_notm}} restarts the replication from where the old replication job stopped.
362
-
363
-
If a self-hosted CouchDB service does _not* support HTTPS, CouchDB can mediate replication jobs instead of {{site.data.keyword.cloudant_short_notm}}. For example, stop the replication job that runs on the {{site.data.keyword.cloudant_short_notm}} side and set up a replication job on a self-hosted Apache CouchDB service to "pull" the data from {{site.data.keyword.cloudant_short_notm}}.
364
-
365
-
{{site.data.keyword.cloudant_short_notm}} supports only `https://` traffic, so if {{site.data.keyword.cloudant_short_notm}} is to be the `source` or `target` in a self-hosted replication definition, it must be configured with an `https://` prefix.
0 commit comments