Querying in ClickHouse CloudThe data in this system table is held locally on each node in ClickHouse Cloud. Obtaining a complete view of all data, therefore, requires the
clusterAllReplicas function. See here for further details.Description
Contains information about all successful and failed login and logout events. Availabilitysystem.session_log is created only when the server configuration contains a session_log section. The section is commented out in the default configuration, so queries against the table fail with UNKNOWN_TABLE until it is enabled. For example:
Reading rotated tables after an upgrade
When a new value is added to theinterface enumeration, the table already stored on disk keeps the older Enum8 definition. On the first start of the new version, system.session_log is renamed to system.session_log_<N> and a fresh table with the current schema is created in its place; the schema of the rotated table is not changed.
If a login was recorded over an interface that was missing from the enumeration of the version that wrote it — for example an ArrowFlight login on a version where ArrowFlight was absent from the interface enumeration — the rotated table contains a raw value that its own enumeration does not define, and a SELECT from it throws Unexpected value 10 in enum. Extend the enumeration of that table to read it; this is a metadata-only operation which does not rewrite any data:
Columns
hostname(LowCardinality(String)) — Hostname of the server executing the query.clickhouse_version(LowCardinality(String)) — Version of the ClickHouse server that produced the row.system_processor(LowCardinality(String)) — CPU architecture of the ClickHouse server that produced the row.type(Enum8(‘LoginFailure’ = 0, ‘LoginSuccess’ = 1, ‘Logout’ = 2)) — Login/logout result. Possible values: LoginFailure — Login error. LoginSuccess — Successful login. Logout — Logout from the system.auth_id(UUID) — Authentication ID, which is a UUID that is automatically generated each time user logins.session_id(String) — Session ID that is passed by client via HTTP interface.event_date(Date) — Login/logout date.event_time(DateTime) — Login/logout time.event_time_microseconds(DateTime64(6)) — Login/logout starting time with microseconds precision.user(Nullable(String)) — User name.auth_type(Nullable(Enum8(‘NO_PASSWORD’ = 0, ‘PLAINTEXT_PASSWORD’ = 1, ‘SHA256_PASSWORD’ = 2, ‘DOUBLE_SHA1_PASSWORD’ = 3, ‘LDAP’ = 4, ‘KERBEROS’ = 5, ‘SSL_CERTIFICATE’ = 6, ‘BCRYPT_PASSWORD’ = 7, ‘SSH_KEY’ = 8, ‘HTTP’ = 9, ‘JWT’ = 10, ‘SCRAM_SHA256_PASSWORD’ = 11, ‘NO_AUTHENTICATION’ = 12))) — The authentication type.profiles(Array(LowCardinality(String))) — The list of profiles set for all roles and/or users.roles(Array(LowCardinality(String))) — The list of roles to which the profile is applied.settings(Array(Tuple(LowCardinality(String), String))) — Settings that were changed when the client logged in/out.client_address(IPv6) — The IP address that was used to log in/out.client_port(UInt16) — The client port that was used to log in/out.interface(Enum8(‘TCP’ = 1, ‘HTTP’ = 2, ‘gRPC’ = 3, ‘MySQL’ = 4, ‘PostgreSQL’ = 5, ‘Local’ = 6, ‘TCP_Interserver’ = 7, ‘Prometheus’ = 8, ‘Background’ = 9, ‘ArrowFlight’ = 10)) — The interface from which the login was initiated.client_hostname(String) — The hostname of the client machine where the clickhouse-client or another TCP client is run.client_name(String) — The clickhouse-client or another TCP client name.client_revision(UInt32) — Revision of the clickhouse-client or another TCP client.client_version_major(UInt32) — The major version of the clickhouse-client or another TCP client.client_version_minor(UInt32) — The minor version of the clickhouse-client or another TCP client.client_version_patch(UInt32) — Patch component of the clickhouse-client or another TCP client version.failure_reason(String) — The exception message containing the reason for the login/logout failure.certificate_subjects(Array(LowCardinality(String))) — The list of subjects (Common Name and Subject Alternative Names) of the TLS client certificate presented on the connection, in the form ‘CN:…’ / ‘SAN:…’. Empty if no certificate was presented.certificate_serial(LowCardinality(String)) — Serial number of the TLS client certificate. Empty if no certificate was presented.certificate_issuer(LowCardinality(String)) — Issuer of the TLS client certificate. Empty if no certificate was presented.certificate_not_before(Nullable(DateTime64(0, ‘UTC’))) — Time from which the TLS client certificate is valid. NULL if no certificate was presented.certificate_not_after(Nullable(DateTime64(0, ‘UTC’))) — Time after which the TLS client certificate expires. NULL if no certificate was presented.
Example
Query
Response