system.session_log

成功・失敗したログイン・ログアウトイベントに関する情報が含まれています。

• hostname (LowCardinality(String)) — クエリを実行するサーバーのホスト名。
• type (Enum8('LoginFailure' = 0, 'LoginSuccess' = 1, 'Logout' = 2)) — ログイン/ログアウトの結果。設定可能な値: LoginFailure — ログインエラー。LoginSuccess — ログイン成功。Logout — システムからのログアウト。
• auth_id (UUID) — 認証 ID。ユーザーがログインするたびに自動生成される UUID です。
• session_id (String) — クライアントが HTTP インターフェイス経由で渡すセッション ID。
• event_date (Date) — ログイン/ログアウトの日付。
• event_time (DateTime) — ログイン/ログアウトの時刻。
• event_time_microseconds (DateTime64(6)) — マイクロ秒精度を含むログイン/ログアウト開始時刻。
• user (Nullable(String)) — ユーザー名。
• 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))) — 認証の種類。
• profiles (Array(LowCardinality(String))) — すべてのロールおよび/またはユーザーに設定されたプロファイルの一覧。
• roles (Array(LowCardinality(String))) — プロファイルが適用されるロールの一覧。
• settings (Array(Tuple(LowCardinality(String), String))) — クライアントのログイン/ログアウト時に変更された設定。
• client_address (IPv6) — ログイン/ログアウトに使用された IP アドレス。
• client_port (UInt16) — ログイン/ログアウトに使用されたクライアントポート。
• interface (Enum8('TCP' = 1, 'HTTP' = 2, 'gRPC' = 3, 'MySQL' = 4, 'PostgreSQL' = 5, 'Local' = 6, 'TCP_Interserver' = 7, 'Prometheus' = 8, 'Background' = 9, 'ArrowFlight' = 10)) — ログイン元のインターフェイス。
• client_hostname (String) — clickhouse-client または他の TCP クライアントが実行されているクライアントマシンのホスト名。
• client_name (String) — clickhouse-client または他の TCP クライアントの名前。
• client_revision (UInt32) — clickhouse-client または他の TCP クライアントのリビジョン。
• client_version_major (UInt32) — clickhouse-client または他の TCP クライアントのメジャーバージョン。
• client_version_minor (UInt32) — clickhouse-client または他の TCP クライアントのマイナーバージョン。
• client_version_patch (UInt32) — clickhouse-client または他の TCP クライアントのバージョンのパッチ部分。
• failure_reason (String) — ログイン/ログアウト失敗の理由を示す例外メッセージ。
• certificate_subjects (Array(LowCardinality(String))) — 接続時に提示された TLS クライアント証明書の subject (Common Name および Subject Alternative Names) の一覧。形式は 'CN:…' / 'SAN:…' です。証明書が提示されていない場合は空です。
• certificate_serial (LowCardinality(String)) — TLS クライアント証明書のシリアル番号。証明書が提示されていない場合は空です。
• certificate_issuer (LowCardinality(String)) — TLS クライアント証明書の発行者。証明書が提示されていない場合は空です。
• certificate_not_before (Nullable(DateTime64(0, 'UTC'))) — TLS クライアント証明書が有効になる時刻。証明書が提示されていない場合は NULL です。
• certificate_not_after (Nullable(DateTime64(0, 'UTC'))) — TLS クライアント証明書の有効期限が切れる時刻。証明書が提示されていない場合は NULL です。

SELECT * FROM system.session_log LIMIT 1 FORMAT Vertical;

Row 1:
──────
hostname:                clickhouse.eu-central1.internal
type:                    LoginSuccess
auth_id:                 45e6bd83-b4aa-4a23-85e6-bd83b4aa1a23
session_id:
event_date:              2021-10-14
event_time:              2021-10-14 20:33:52
event_time_microseconds: 2021-10-14 20:33:52.104247
user:                    default
auth_type:               PLAINTEXT_PASSWORD
profiles:                ['default']
roles:                   []
settings:                [('load_balancing','random'),('max_memory_usage','10000000000')]
client_address:          ::ffff:127.0.0.1
client_port:             38490
interface:               TCP
client_hostname:
client_name:             ClickHouse client
client_revision:         54449
client_version_major:    21
client_version_minor:    10
client_version_patch:    0
failure_reason:
certificate_subjects:    []
certificate_serial:
certificate_issuer:
certificate_not_before:  ᴺᵁᴸᴸ
certificate_not_after:   ᴺᵁᴸᴸ

interface 列挙型に新しい値が追加されても、すでにディスクに保存されているテーブルには古い Enum8 定義が保持されます。新しいバージョンを初めて起動すると、system.session_log は system.session_log_<N> にリネームされ、その代わりに現在のスキーマを持つ新しいテーブルが作成されます。ローテーションされたテーブルのスキーマは変更されません。

テーブルへの書き込みに使用したバージョンの列挙型に存在しないインターフェイス経由でログインが記録された場合、たとえば interface 列挙型に ArrowFlight がないバージョンで ArrowFlight 経由のログインが記録された場合、ローテーションされたテーブルには、そのテーブル自身の列挙型で定義されていない生の値が含まれます。そのため、このテーブルに対する SELECT では Unexpected value 10 in enum がスローされます。読み取るには、そのテーブルの列挙型を拡張してください。これはメタデータのみを変更する操作であり、データは書き換えられません。

ALTER TABLE system.session_log_1
    MODIFY COLUMN interface Enum8('TCP' = 1, 'HTTP' = 2, 'gRPC' = 3, 'MySQL' = 4, 'PostgreSQL' = 5, 'Local' = 6, 'TCP_Interserver' = 7, 'Prometheus' = 8, 'Background' = 9, 'ArrowFlight' = 10);