セットアップガイド
以下の手順で、Apache Kafka を Connect AI アカウントに接続します：タイプ検出スキーム
- None
- RowScan
- SchemaRegistry
- SchemaRegistryAggregate
- MessageOnly
スキーマレジストリのエンドポイントである Registry URL を入力します。このプロパティが指定されると、プロバイダーはサーバーから Avro および JSON スキーマを読み取ることができます。
プロバイダーが Apache Kafka トピックのキーおよび値スキーマを取得するために使用する Registry Service を選択します。オプションは Confluent と AWSGlue です。
プロバイダーがスキーマレジストリに接続する際に使用する Registry Auth Scheme を選択します。オプションは None、Basic、SSLCertificate です。Basic を選択した場合は、スキーマレジストリへの認証に使用する Registry User と Registry Password も入力します。
（オプション）Schema Merge Mode を選択します。これは、プロバイダーが複数バージョンを持つスキーマをどのように公開するかを指定します。オプションは None と Simple です。
（オプション）Non Registry Type Detection Scheme を選択します。これは、スキーマレジストリにスキーマがないトピックに使用するタイプ検出スキームを指定します。オプションは Disabled、None、RowScan、MessageOnly です。
（オプション）Non Registry Type Detection Scheme を選択します。これは、スキーマレジストリにスキーマがないトピックに使用するタイプ検出スキームを指定します。オプションは Disabled、None、RowScan、MessageOnly です。
プロバイダーが Apache Kafka ブローカーへ接続する際に使用する Auth Scheme を選択し、認証 セクションに進みます。
認証
- None
- Plain
- SCRAM
- SCRAM-SHA-512
- Kerberos
- SSLCertificate
- KafkaOAuthClient
- AzureAD
- AzureServicePrincipal
- AzureServicePrincipalCert
- OAuthJWT
- AWSWorkloadIdentity
- AzureWorkloadIdentity
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
SSL クライアント証明書の形式を指定する SSL Client Cert Type を選択します。オプションは JKSFILE、PFXFILE、PEMKEY_FILE、PEMKEY_BLOB です。
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
カスタム OAuth アプリケーションに割り当てられた OAuth Client Id（コンシューマーキーとも呼ばれます）を入力します。この ID は、認証時に OAuth 認可サーバーに対してアプリケーションを識別するために必要です。
カスタム OAuth アプリケーションに割り当てられた OAuth Client Secret を入力します。この機密値は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
データへのアクセスに使用される Apache Kafka テナントを識別する Azure Tenant を入力します。このフィールドは、テナントのドメイン名（例：contoso.onmicrosoft.com）またはそのディレクトリ（テナント）ID を受け付けます。
カスタム OAuth アプリケーションに割り当てられた OAuth Client Id（コンシューマーキーとも呼ばれます）を入力します。この ID は、認証時に OAuth 認可サーバーに対してアプリケーションを識別するために必要です。
カスタム OAuth アプリケーションに割り当てられた OAuth Client Secret を入力します。この機密値は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
データへのアクセスに使用される Apache Kafka テナントを識別する Azure Tenant を入力します。このフィールドは、テナントのドメイン名（例：contoso.onmicrosoft.com）またはそのディレクトリ（テナント）ID を受け付けます。
カスタム OAuth アプリケーションに割り当てられた OAuth Client Id（コンシューマーキーとも呼ばれます）を入力します。この ID は、認証時に OAuth 認可サーバーに対してアプリケーションを識別するために必要です。
カスタム OAuth アプリケーションに割り当てられた OAuth Client Secret を入力します。この機密値は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
データへのアクセスに使用される Apache Kafka テナントを識別する Azure Tenant を入力します。このフィールドは、テナントのドメイン名（例：contoso.onmicrosoft.com）またはそのディレクトリ（テナント）ID を受け付けます。
カスタム OAuth アプリケーションに割り当てられた OAuth Client Id（コンシューマーキーとも呼ばれます）を入力します。この ID は、認証時に OAuth 認可サーバーに対してアプリケーションを識別するために必要です。
カスタム OAuth アプリケーションに割り当てられた OAuth Client Secret を入力します。この機密値は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。
JWT 証明書を含むキーストアの種類を指定する OAuth JWT Cert Type を選択します。オプションは PFXBLOB、JKSBLOB、PEMKEY_BLOB、PUBLIC_KEY_BLOB、SSHPUBLIC_KEY_BLOB、XMLBLOB、BCFKSBLOB、GOOGLEJSONBLOB です。
（オプション）OAuth JWT Cert Password を入力します。これは、パスワード保護された証明書ストアへのアクセスに使用する OAuth JWT 証明書のパスワードです。証明書ストアがパスワードを必要としない場合は、このプロパティを空白のままにします。
（オプション）ストア内で一致する証明書を検索するために使用する OAuth JWT 証明書の OAuth JWT Cert Subject を入力します。部分一致、および最初の証明書を選択するワイルドカード ’*’ をサポートします。
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
JWT 証明書を含むキーストアの種類を指定する OAuth JWT Cert Type を選択します。オプションは PFXBLOB、JKSBLOB、PEMKEY_BLOB、PUBLIC_KEY_BLOB、SSHPUBLIC_KEY_BLOB、XMLBLOB、BCFKSBLOB、GOOGLEJSONBLOB です。
（オプション）OAuth JWT Cert Password を入力します。これは、パスワード保護された証明書ストアへのアクセスに使用する OAuth JWT 証明書のパスワードです。証明書ストアがパスワードを必要としない場合は、このプロパティを空白のままにします。
（オプション）ストア内で一致する証明書を検索するために使用する OAuth JWT 証明書の OAuth JWT Cert Subject を入力します。部分一致、および最初の証明書を選択するワイルドカード ’*’ をサポートします。
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。
Azure 経由で Workload Identity Federation を使用する際に提供する設定プロパティである Azure Workload Identity Config を入力します。
Connect AI Add Connection ページ上部の、Save & Test をクリックします。
- 接続テストに成功すると、コネクションが作成されたことを示すConnection successfully saved というメッセージが表示されます。Edit Connection ページのStatus もAuthenticated に変わります。Edit Connection ページの右ペインにあるData Model タブで、成功したコネクションのデータモデルを表示します。
- 接続テストに失敗した場合は、入力したログイン情報に余分なスペースや文字がないかを確認してください。Connect AI は、データが不足している必須フィールドの下にエラーメッセージを表示します。一部のデータソースでは、ソースのWeb サイトに直接サインインする必要があります。サインインしていない場合は、Sign in ボタンの下にエラーメッセージが表示されます。エラーを修正し、もう一度試してください。
- 失敗したコネクションは下書きとして保存され、Status はNot Authenticated になります。後でコネクションに戻って認証することができます。