SKILLOfficialdevelopment

aidp-connectors-overview

プラグイン: oracle-ai-data-platform-workbench-spark-connectors
ソース: GitHub で見る ↗

説明

# 訳文 AIDP ノートブックからユーザーのデータソースに合った適切なコネクタスキル（接続ツール）を選ぶ手助けをします。ユーザーが複数のデータソースに言及している場合、どのコネクタが適用されるか確信がない場合、または「AIDP から X に接続するにはどうすればよいか」と質問する場合に、案内役として使用します。 26 種類のデータソースに対応しています。 **Oracle 関連** - Oracle Autonomous DB ファミリー（ALH/ADW/ATP） - 汎用 Oracle DB - ExaCS - PeopleSoft - Siebel - Fusion ERP/BICC - EPM Cloud - Essbase **Oracle Cloud Infrastructure（OCI）関連** - OCI Streaming - Object Storage **その他のクラウド・データベース** - Iceberg - PostgreSQL - MySQL/HeatWave - DB2 - SQL Server - Azure SQL - Hive - Snowflake - Azure ADLS **外部サービス・ストレージ** - AWS S3 - Salesforce - NetSuite **その他** - 汎用 REST（Web API） - カスタム JDBC（Java データベース接続） - Excel

原文を表示

Help the user pick the right connector skill for their data source from an AIDP notebook. Use as a router when the user mentions multiple sources, isn't sure which connector applies, or asks "how do I connect to X from AIDP". Covers 26 data sources — Oracle Autonomous DB family (ALH/ADW/ATP), generic Oracle DB, ExaCS, PeopleSoft, Siebel, Fusion ERP/BICC, EPM Cloud, Essbase, OCI Streaming, Object Storage, Iceberg, plus PostgreSQL, MySQL/HeatWave, DB2, SQL Server, Azure SQL, Hive, Snowflake, Azure ADLS, AWS S3, Salesforce, NetSuite, generic REST, custom JDBC, Excel.

ユースケース

複数のデータソースに接続するとき
適切なコネクタが不明なとき
AIDP から特定のデータソースへの接続方法を確認するとき

本文（日本語訳）

`aidp-connectors-overview` — 正しいコネクターを選ぶ

使用する場面

ユーザーが選択肢を検討している（「OracleにAIDPから接続するには？」「どのコネクターを使うべき？」など）
ユーザーが複数のOracleデータソースを同時に言及している
ユーザーが製品名ではなく機能で説明している（例：「OLAPキューブ」「ストリーミングデータ」など）

使用しない場面

ユーザーが既に対象製品を名指ししている（ALH、ATP、Fusion など）— 該当する aidp-<製品名> スキルを直接呼び出す

ルーティング方法

どのコネクタースキルを使う前にも、ユーザーのAIDP ワークスペースにヘルパーパッケージをアップロードしておく必要があります。まだアップロードしていない場合（または過去のセルで ModuleNotFoundError: oracle_ai_data_platform_connectors というエラーが見られた場合）、まず aidp-connectors-bootstrap を呼び出してください。このスキルはAIDP MCP ツールを使ってパッケージを /Workspace/Shared/ にデプロイし、動作確認用ノートブックを実行します。

その後、下の表から正しいスキルを選んでそのスキルを呼び出してください。ここに内容を書き直さないでください。

Oracle / OCI データソース

ユーザーが述べたキーワード	使用するスキル
「ALH」「AI Lakehouse」「ADW」「ATP」「Autonomous Database」「26ai」	`aidp-alh` — Autonomous DB ファミリー（ウォレット/IAM DB-Token/APIキー）
「Oracle Database」「汎用Oracle DB」「オンプレミスOracle」「Oracle 19c / 21c」「Base DB」「Compute上のOracle」非Autonomous Oracle	`aidp-oracle-db` — TCP 1521でのユーザー名/パスワード接続
「ExaCS」「Exadata」「Exadata Cloud」「プライベートサブネットのOracle DB」	`aidp-exacs`
「PeopleSoft」「PSFT」「PS HCM」「FSCM」「Campus Solutions」	`aidp-peoplesoft`
「Siebel」「Siebel CRM」「S_CONTACT」「S_ORG_EXT」	`aidp-siebel`
「Fusion ERP」「Fusion HCM」「Fusion REST」「FA REST」「Cloud ERP API」	`aidp-fusion-rest`
「BICC」「BI Cloud Connector」「Fusion一括抽出」「Fusionから5万行以上」	`aidp-fusion-bicc`
「EPM Cloud」「EPBCS」「Hyperion Planning」「Planning アプリ」「exportdataslice」	`aidp-epm-cloud`
「Essbase」「Essbase 21c」「MDX」「OLAPキューブ」「キューブREST」	`aidp-essbase`
「OCI Streaming」「OCI上のKafka」「ストリームプール」「Kafkaストリーミング」	`aidp-streaming-kafka`
「OCI Object Storage」「oci://」「外部ボリューム」「バケット上の外部テーブル」	`aidp-object-storage`
「Iceberg」「Apache Iceberg」「タイムトラベル」「スナップショット」「スキーマ進化」	`aidp-iceberg`

外部リレーショナルDB / Hadoop（Oracle以外）

ユーザーが述べたキーワード	使用するスキル
「PostgreSQL」「Postgres」「psql」	`aidp-postgresql`
「MySQL」「HeatWave」「MDS」「MySQL Database Service」	`aidp-mysql`
「SQL Server」「MSSQL」「TDS」	`aidp-sqlserver`
「Azure SQL」「Azure SQL Database」「database.windows.net」	`aidp-azuresql`
「DB2」「Db2」「IBM Db2」「LUW」	`aidp-db2`
「Hive」「HiveServer2」「HS2」「HCatalog」Kerberos未使用のHive	`aidp-hive`

SaaS

ユーザーが述べたキーワード	使用するスキル
「Salesforce」「SFDC」「Sales Cloud」「Service Cloud」「sObject」「SOQL」「Account/Opportunity/Lead」	`aidp-salesforce`
「NetSuite」「SuiteAnalytics Connect」「ns.account.id」「ns.role.id」「ns.access.token」	`aidp-netsuite`

マルチクラウド＆代替方法

ユーザーが述べたキーワード	使用するスキル
「Snowflake」「sfUrl」「sfWarehouse」	`aidp-snowflake`
「ADLS」「Azure Data Lake」「abfss」	`aidp-azure-adls`
「S3」「AWS S3」「s3a」	`aidp-aws-s3`
「汎用REST」「マニフェストURL」「manifest.path」マニフェストスキーマ付きRESTエンドポイント	`aidp-rest-generic`
「カスタムJDBC」「ClickHouse」「DuckDB」「SAP HANA」専用スキルがないDB	`aidp-jdbc-custom`
「.xlsx」「Excel」「スプレッドシート取り込み」	`aidp-excel`

AIDBプラットフォームレベルで対応不可（試さないでください）

インスタンスプリンシパル — AIDBノートブックからIMDS（169.254.169.254）に到達できません。署名生成は失敗するか、顧客ではなくAIDBのサービステナンシーで実行されます。
リソースプリンシパル — AIDBは AIDP_AUTH=resource_principal を設定しますが、OCI_RESOURCE_PRINCIPAL_RPST / OCI_RESOURCE_PRINCIPAL_PRIVATE_PEM は提供しないため、get_resource_principals_signer() がエラーになります。

ユーザーがどちらかを望む場合、APIキー＋インラインOCI設定（oracle_ai_data_platform_connectors.auth.from_inline_pem）を勧めてください。AIDBチームは認識していますが、Oracleの対応待ちです。

すべてのコネクターが継承するAIDB共通の注意点

認証情報は /tmp/ 配下に置く — 決して /Workspace/ ではなく。後者はFUSEマウント済みのため、接続が不安定になったり os.chmod が効きません。
JDBCドライバープロセス用のファイル は事前にワールド読み取り可能にする必要があります（os.open(..., O_WRONLY|O_CREAT, 0o666)）。
Sparkストリーミングのチェックポイント は /Volumes/<カタログ>/<スキーマ>/<ボリューム>/... 配下に置く — 決して /Workspace/ や oci:// ではなく。
ライブテスト前にAIDPセッショントークンをリフレッシュ：oci session authenticate --profile AIDP_SESSION --region us-ashburn-1

参考資料

プラグインREADME：../../README.md
ライブテストマトリクス＆結果：../../tests/live-results/RESULTS.md
AIDPノートブック認証調査：Claude context/AIDP/AIDP Context/AIDP/aidp-notebook-authentication.md

原文（English）を表示

`aidp-connectors-overview` — pick the right connector skill

When to use

The user is exploring options ("how do I connect to Oracle from AIDP?", "which connector should I use?").
The user mentions multiple Oracle sources at once.
The user describes a source by capability (e.g. "OLAP cube", "structured streaming") rather than naming the product directly.

When NOT to use

The user has already named their target product (ALH, ATP, Fusion, etc.) — invoke the matching aidp-<product> skill directly.

How to route

Before any connector skill works, the helper package must be uploaded to the user's AIDP workspace. If the user hasn't done this yet (or you see ModuleNotFoundError: oracle_ai_data_platform_connectors in any prior cell), invoke aidp-connectors-bootstrap first. It uses the AIDP MCP tools to push the package into /Workspace/Shared/ and runs a sanity-import notebook.

Otherwise, pick the right skill from this table and invoke that skill. Don't re-write its content here.

Oracle / OCI sources

User says...	Use skill
"ALH", "AI Lakehouse", "ADW", "ATP", "Autonomous Database", "26ai"	`aidp-alh` — Autonomous DB family (wallet / IAM DB-Token / API key)
"Oracle Database", "generic Oracle DB", "on-prem Oracle", "Oracle 19c / 21c", "Base DB", "Oracle on Compute", non-Autonomous Oracle	`aidp-oracle-db` — generic Oracle DB via plain user/password on TCP 1521
"ExaCS", "Exadata", "Exadata Cloud", "private-subnet Oracle DB"	`aidp-exacs`
"PeopleSoft", "PSFT", "PS HCM", "FSCM", "Campus Solutions"	`aidp-peoplesoft`
"Siebel", "Siebel CRM", "S_CONTACT", "S_ORG_EXT"	`aidp-siebel`
"Fusion ERP", "Fusion HCM", "Fusion REST", "FA REST", "Cloud ERP API"	`aidp-fusion-rest`
"BICC", "BI Cloud Connector", "Fusion bulk extract", >50k rows from Fusion	`aidp-fusion-bicc`
"EPM Cloud", "EPBCS", "Hyperion Planning", "Planning app", "exportdataslice"	`aidp-epm-cloud`
"Essbase", "Essbase 21c", "MDX", "OLAP cube", "cube REST"	`aidp-essbase`
"OCI Streaming", "Kafka on OCI", "stream pool", "structured streaming Kafka"	`aidp-streaming-kafka`
"OCI Object Storage", "oci://", "external volume", "external table on bucket"	`aidp-object-storage`
"Iceberg", "Apache Iceberg", "time travel", "snapshots", "schema evolution"	`aidp-iceberg`

External RDBMS / Hadoop (non-Oracle)

User says...	Use skill
"PostgreSQL", "Postgres", "psql"	`aidp-postgresql`
"MySQL", "HeatWave", "MDS", "MySQL Database Service"	`aidp-mysql`
"SQL Server", "MSSQL", "TDS"	`aidp-sqlserver`
"Azure SQL", "Azure SQL Database", "database.windows.net"	`aidp-azuresql`
"DB2", "Db2", "IBM Db2", "LUW"	`aidp-db2`
"Hive", "HiveServer2", "HS2", "HCatalog", non-Kerberos Hive	`aidp-hive`

SaaS

User says...	Use skill
"Salesforce", "SFDC", "Sales Cloud", "Service Cloud", "sObject", "SOQL", "Account / Opportunity / Lead"	`aidp-salesforce`
"NetSuite", "SuiteAnalytics Connect", "ns.account.id", "ns.role.id", "ns.access.token"	`aidp-netsuite`

Multi-cloud + escape hatches

User says...	Use skill
"Snowflake", "sfUrl", "sfWarehouse"	`aidp-snowflake`
"ADLS", "Azure Data Lake", "abfss"	`aidp-azure-adls`
"S3", "AWS S3", "s3a"	`aidp-aws-s3`
"Generic REST", "manifest URL", "manifest.path", REST endpoint with manifest schema	`aidp-rest-generic`
"Custom JDBC", "ClickHouse", "DuckDB", "SAP HANA", any DB without a dedicated skill	`aidp-jdbc-custom`
".xlsx", "Excel", "spreadsheet ingestion"	`aidp-excel`

What's blocked at the AIDP platform level (so you don't try)

Instance Principal — IMDS (169.254.169.254) is unreachable from AIDP notebooks; signer either fails or runs in AIDP's service tenancy, not the customer's.
Resource Principal — AIDP sets AIDP_AUTH=resource_principal but does NOT provide OCI_RESOURCE_PRINCIPAL_RPST / OCI_RESOURCE_PRINCIPAL_PRIVATE_PEM, so get_resource_principals_signer() raises.

If the user wants either of those, point them at API Key + inline OCI config (oracle_ai_data_platform_connectors.auth.from_inline_pem) instead. The AIDP team is aware; pending Oracle action.

Cross-cutting AIDP gotchas (every connector inherits these)

Credentials live under /tmp/ — never /Workspace/. The latter is FUSE-mounted; intermittent disconnects + os.chmod no-op.
Files written for the JDBC driver process must be world-readable up-front via os.open(..., O_WRONLY|O_CREAT, 0o666).
Spark streaming checkpoints must live under /Volumes/<catalog>/<schema>/<volume>/..., never /Workspace/, never oci://.
Refresh the AIDP session token before live testing: oci session authenticate --profile AIDP_SESSION --region us-ashburn-1.

References

Plugin README: ../../README.md
Live-test matrix + results: ../../tests/live-results/RESULTS.md
AIDP notebook auth investigation: Claude context/AIDP/AIDP Context/AIDP/aidp-notebook-authentication.md

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。