7.191 DBMS_KAFKA_SEC_ALLOWED_PROPERTIES

DBMS_KAFKA_SEC_ALLOWED_PROPERTIESは、有効なOracle SQL Access to Kafka (OSAK)セキュリティ・プロパティを表示します。

DBMS_KAFKA_SEC_ALLOWED_PROPERTIESは、データベースのインストール時に作成および移入されるシステム表です。librdkafkaライブラリで必要とされるセキュリティ構成プロパティを含む、osakafka.propertiesファイルで許可されるプロパティが表示されます。

インストール後すぐに、DBMS_KAFKA_SEC_ALLOWED_PROPERTIESには、表7-1にリストされているKafka (OSAK)セキュリティ・プロパティの最初のOracle SQL Access to Kafka (OSAK)が表示されます。その後、OSAK_ADMIN_ROLEロールを持つユーザーは、DBMS_KAFKA_SEC_ALLOWED_PROPERTIESを表示して、必要に応じて、またはOracleサポートから提示されたこの表にプロパティを追加できます。DBMS_KAFKA_SEC_ALLOWED_PROPERTIES表に表示されるプロパティのみがosakafka.propertiesファイルから読み取られます。

列 データ型 NULL 説明

PROPERTY_NAME

VARCHAR2(200)

NOT NULL

セキュリティ・プロパティの名前

DESCRIPTION

VARCHAR2(4000)

セキュリティ・プロパティの説明

表7-1 Oracle SQL Access to Kafka (OSAK)の初期セキュリティ・プロパティ

プロパティ名 説明

debug

rdkafkaクライアントのデバッグ出力を有効にします。デバッグ情報は、Oracleトレース・ファイルに記録されます。使用可能な値はallのみです。

max.partition.fetch.bytes

単一のパーティションのポーリングでKafkaサーバーが戻すことができる最大バイト数。これは正の整数値です。Oracle Cloud Infrastructure (OCI)ストリーミング・サービスのKafkaでは、パーティションごとにリクエスト・サイズを1MBに制限することをお薦めします。

osak.kgmps.max.message.size

単一のパーティションのポーリングでKafkaクライアントがフェッチできる最大バイト数。これは、デフォルトの1MBの正の整数値です。このパラメータはmax.partition.fetch.bytesとともに、1MBを超える単一のKafkaレコードを取得できます。

sasl.kerberos.ccname

KafkaクラスタのKerberos資格証明(チケット)キャッシュ(KRB5CCNAME)のファイル名

sasl.kerberos.config

KafkaクラスタのKerberos構成ファイル(krb5.conf)のファイル名

sasl.kerberos.principal

KafkaクライアントKerberosプリンシパル名

sasl.kerberos.service.name

Kafka Broker JAAS構成ファイルで指定されたKerberosプリンシパルのプライマリ名

次にその例を示します。

一般的なKerberos V5プリンシパルの形式は、primary/instance@REALMです。

したがって、Kafka Broker JAAS構成ファイルで次が指定されている場合:

principal="kafka/example.hostname.com@EXAMPLEREALM.COM"

この場合、sasl.kerberos.service.nameの値はkafkaになります。

sasl.mechanism

認証に使用する簡易認証およびセキュリティ・レイヤー(SASL)メカニズム。これは、sasl.mechanismsプロパティの別名です。指定できる値は、GSSAPI、PLAIN、SCRAM-SHA-256およびSCRAM-SHA-512です。使用できる値は1つのみです。デフォルト値はGSSAPIです。

sasl.mechanisms

認証に使用するSASLメカニズム。指定できる値は、GSSAPI、PLAIN、SCRAM-SHA-256およびSCRAM-SHA-512です。使用できる値は1つのみです。デフォルト値はGSSAPIです。

sasl.username

SASL認証のユーザー名

security.protocol

Kafkaブローカとの通信に使用されるプロトコル。指定できる値は、plaintext、ssl、sasl_plaintextおよびsasl_sslです。使用できる値は1つのみです。

ssl.ca.location

Kafkaブローカ・キーを検証するための認証局(CA)ファイルのファイル名

ssl.certificate.location

プライバシ拡張メール(PEM)形式のKafkaクライアント証明書のファイル名

ssl.endpoint.identification.algorithm

Kafkaブローカ証明書を使用してKafkaブローカ・ホスト名を検証するためのエンドポイント識別アルゴリズム。指定できる値は、httpsおよびnoneです。デフォルト値はnoneです。

ssl.key.location

Kafkaクライアント秘密キーのファイル名

ノート:

このビューは、Oracle Database 23ai以降で使用できます。

関連項目:

osakafka.propertiesファイルの詳細は、『Oracle Databaseユーティリティ』を参照してください。