PersistenceLocation

PersistenceLocation["type"]

represents a persistence location of the given type.

PersistenceLocation["type",base]

includes the base address for a location type that allows multiple locations.

Details

  • Supported location types include:
  • "KernelSession"current invocation of the Wolfram Language kernel
    "FrontEndSession"current invocation of the Wolfram Notebook front end
    "ServerSession"persistence for requests on a single web server
    "CookieManaged"persistence based on a Wolfram browser cookie
    "Local"local to a computer, based on user home directory
    "LocalShared"local to a computer, based on $BaseDirectory
    "Cloud"in the cloud defined by the current $CloudBase
    "Installation"installation defaults
  • PersistenceLocation["type","base"] can also be given as PersistenceLocation["type""base"].
  • In functions such as PersistentValue that use persistence locations, the forms "type" and "type"->"base" can be used and are equivalent to PersistenceLocation["type"] and PersistenceLocation["type","base"].
  • In PersistenceLocation["type"], the default base is determined by type as follows:
  • "Local"LocalObject["Persistence",$DefaultLocalBase]
    "LocalShared"LocalObject["Persistence",$BaseDirectory]
    "Cloud"CloudObject["/Persistence"]
  • DeleteObject[PersistenceLocation["type"]] deletes all objects stored in the given persistence location.
  • "ServerSession" specifies that values will be persistent only when the same server (typically with the same $MachineName) is used. In typical cloud configurations, successive requests will be executed on the same server when possible. With the "ServerSession" persistence location, actual values are stored on the server, and are typically referenced by a cookie in the browser.
  • "CookieManaged" specifies that values will be referenced by a browser cookie named "WolframPersistentCookie", and will persist as long as that cookie lasts. The actual values are stored in the cloud, and are available to all servers within a given cloud.
  • The default persistence time for "CookieManaged" is set for a particular cloud; for the Wolfram Cloud, it is typically one year. A shorter persistence time for a particular value can be specified by giving a setting for PersistenceTime.
  • "ServerSession" typically allows values to be retrieved and set more efficiently than "CookieManaged", since it maintains data directly on the server and does not require access to the cloud object store.

Examples

open all close all

Basic Examples  (3)

The "Local" persistence location stores values as local objects under $LocalBase:

In[1]:=
Click for copyable input
Out[1]=

The "FrontEndSession" persistence location stores values in the running Wolfram Notebook front end:

In[1]:=
Click for copyable input
Out[1]=

The "Cloud" persistence location stores values as cloud objects:

In[1]:=
Click for copyable input
Out[1]=

Scope  (7)

Generalizations & Extensions  (4)

Properties & Relations  (4)

Possible Issues  (3)

Introduced in 2017
(11.1)
|
Updated in 2019
(12.0)