atoti.Session.connect

Documentation Index

Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt

Use this file to discover all available pages before exploring further.

​

classmethod Session.connect(url, *, authentication=None, certificate_authority=None)

• Local
  • If all the following conditions are met:
    • 1. the target session requires authentication (e.g. it has security configured)
    • 1. the provided authentication or certificate_authority arguments grant ROLE_ADMIN
    • 1. the target session (the one at url) was started with the same version of Atoti Python SDK (0.9.15)
    • 1. the target session runs on the same host as the current Python process
  • Then all Session capabilities can be used except for:
    • endpoint()
    • logs_path
    • wait()

• Remote
  • If conditions a., b., and c. are met but not d. (i.e., not on the same host)
  • Then all local capabilities are available except those needing a shared file system. For example:
    • load() with CsvLoad or ParquetLoad, read_csv(), and read_parquet() are not available (unless loading from cloud storage)
    • load() with pyarrow.Table or pandas.DataFrame, read_arrow() and read_pandas() methods are not available
• No security management
  • If conditions a. and b. are meet, plus both:
    • 1. the target session runs the same Atoti Server version (e.g. 6.1.20 for Atoti Python SDK 0.9.15)
    • 1. the target session is exposed to Atoti Python SDK
  • Depending on whether d. is met, either local or remote capabilities are available, except for security management features.
• Read-only
  • If only condition e. is met (i.e. matching Atoti Server versions)
  • Then capabilities that modify the session data or data model are unavailable. However, some read-only capabilities remain accessible. For example:
    • Not available: create_table(), create_cube(), and read_csv()
    • Available: atoti.tables.Tables.schema and atoti.Table.query()
• Minimal capabilities
  • Always available:
    • atoti.Session.link
    • atoti.Session.query_mdx
    • atoti.Cube.query

• Parameters:
  • url (str) – The base URL of the target session. The endpoint f"{url}/versions/rest" is expected to exist.
  • authentication (Authenticate | ClientCertificate | None) – The method used to authenticate against the target session.
  • certificate_authority (Path | None) – Path to the custom certificate authority file to use to verify the HTTPS connection. Required when the target session has been configured with an SSL certificate that is not signed by some trusted public certificate authority.
• Return type: Self

​

Example

>>> session_config = tt.SessionConfig(security=tt.SecurityConfig())
>>> target_session = tt.Session.start(session_config)
>>> _ = target_session.create_table("Example", data_types={"Id": "String"})
>>> target_session.security.individual_roles.update(
...     {"user": {"ROLE_USER"}, "admin": {"ROLE_USER", "ROLE_ADMIN"}},
... )
>>> password = "passwd"
>>> target_session.security.basic_authentication.credentials.update(
...     {"user": password, "admin": password}
... )
>>> admin_session = tt.Session.connect(
...     target_session.url,
...     authentication=tt.BasicAuthentication("admin", password),
... )
>>> table = admin_session.tables["Example"]
>>> table += ("foo",)
>>> table.head()
    Id
0  foo

>>> user_session = tt.Session.connect(
...     target_session.url,
...     authentication=tt.BasicAuthentication("user", password),
... )
>>> user_session.ready = False  
Traceback (most recent call last):
    ...
atoti._graphql.client.exceptions.GraphQLClientHttpError: HTTP status code: 400