claude-skills/

Anthropic公式スキル・プラグインの日本語ディレクトリ

last sync 22h ago
スキルOfficialdevelopment

🔌aidp-connectors-overview

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

説明

AIDPノートブックからデータソースに接続する際、適切なコネクタスキルをユーザーが選択できるよう支援します。 次のような場合に使用: - ユーザーが複数のデータソースに言及している場合 - どのコネクタが適用されるか判断できていない場合 - 「AIDPからXに接続するにはどうすればよいか」と質問している場合 以下の23種類のデータソースに対応しています — Oracle Autonomous DBファミリー（ALH / ADW / ATP）、汎用Oracle DB、ExaCS、PeopleSoft、Siebel、Fusion ERP / BICC、EPM Cloud、Essbase、OCI Streaming、Object Storage、Iceberg、 PostgreSQL、MySQL / HeatWave、SQL Server、Hive、Snowflake、Azure ADLS、AWS S3、Salesforce、汎用REST、カスタムJDBC、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 23 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, SQL Server, Hive, Snowflake, Azure ADLS, AWS S3, Salesforce, generic REST, custom JDBC, Excel.

ユースケース

  • ✓複数のデータソースに接続するコネクタを選択
  • ✓適切なコネクタが判断できていない
  • ✓AIDPからデータソースへの接続方法を確認

本文（日本語訳）

aidp-connectors-overview — 適切なコネクタスキルの選択

次のような場合に使用:

  • ユーザーが選択肢を模索している場合（「AIDPからOracleに接続するには？」「どのコネクタを使えばいい？」など）
  • ユーザーが複数のOracleソースを同時に挙げている場合
  • ユーザーが製品名ではなく機能で接続先を説明している場合（例: 「OLAPキューブ」「構造化ストリーミング」など）

次のような場合には使用しない:

  • ユーザーがすでに対象製品を明示している場合（ALH、ATP、Fusionなど）— 対応する aidp-<製品名> スキルを直接呼び出すこと

ルーティング方法

コネクタスキルを動作させる前に、ヘルパーパッケージをユーザーのAIDPワークスペースへアップロードする必要があります。 まだ実施していない場合（または直前のセルで ModuleNotFoundError: oracle_ai_data_platform_connectors が発生している場合）は、先に aidp-connectors-bootstrap を呼び出してください。 このスキルはAIDP MCPツールを使用してパッケージを /Workspace/Shared/ へ転送し、動作確認用のnotebookを実行します。

上記が済んでいる場合は、以下の表から適切なスキルを選択してそのスキルを呼び出してください。 ここにその内容を再掲しないこと。

Oracle / OCIソース

ユーザーの発言 使用するスキル
"ALH"、"AI Lakehouse"、"ADW"、"ATP"、"Autonomous Database"、"26ai" aidp-alh — Autonomous DBファミリー（ウォレット / IAM DB-Token / APIキー）
"Oracle Database"、"汎用Oracle DB"、"オンプレOracleDB"、"Oracle 19c / 21c"、"Base DB"、"Oracle on Compute"、非Autonomous Oracle aidp-oracle-db — TCP 1521上のユーザー/パスワードによる汎用Oracle DB接続
"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から50,000行超のデータ取得 aidp-fusion-bicc
"EPM Cloud"、"EPBCS"、"Hyperion Planning"、"Planningアプリ"、"exportdataslice" aidp-epm-cloud
"Essbase"、"Essbase 21c"、"MDX"、"OLAPキューブ"、"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" aidp-object-storage
"Iceberg"、"Apache Iceberg"、"タイムトラベル"、"スナップショット"、"スキーマエボリューション" aidp-iceberg

外部RDBMS / Hadoop（Oracle以外）

ユーザーの発言 使用するスキル
"PostgreSQL"、"Postgres"、"psql" aidp-postgresql
"MySQL"、"HeatWave"、"MDS"、"MySQL Database Service" aidp-mysql
"SQL Server"、"MSSQL"、"Azure SQL"、"TDS" aidp-sqlserver
"Hive"、"HiveServer2"、"HS2"、"HCatalog"、非Kerberos Hive aidp-hive

SaaS

ユーザーの発言 使用するスキル
"Salesforce"、"SFDC"、"Sales Cloud"、"Service Cloud"、"sObject"、"SOQL"、"Account / Opportunity / Lead" aidp-salesforce

マルチクラウド + エスケープハッチ

ユーザーの発言 使用するスキル
"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"、manifestスキーマ付きRESTエンドポイント aidp-rest-generic
"Custom JDBC"、"ClickHouse"、"DuckDB"、"DB2"、"SAP HANA"、専用スキルのない任意のDB aidp-jdbc-custom
".xlsx"、"Excel"、"スプレッドシートのインジェスト" aidp-excel

AIDPプラットフォームレベルでブロックされている機能（試みないこと）

  • Instance Principal — IMDS（169.254.169.254）はAIDPのnotebookから到達不可。signerは失敗するか、顧客テナンシーではなくAIDPのサービステナンシーで動作してしまう。
  • Resource Principal — AIDPは AIDP_AUTH=resource_principal を設定するが、OCI_RESOURCE_PRINCIPAL_RPST / OCI_RESOURCE_PRINCIPAL_PRIVATE_PEM を提供しないため、get_resource_principals_signer() がエラーになる。

上記いずれかを希望するユーザーには、APIキー + インラインOCI config（oracle_ai_data_platform_connectors.auth.from_inline_pem）を案内してください。 AIDPチームは本件を把握しており、Oracle側の対応待ちです。

AIDPの共通注意事項（全コネクタに共通）

  1. クレデンシャルは /tmp/ 配下に保存する — /Workspace/ 配下には置かない。 後者はFUSEマウントであるため、断続的な切断や os.chmod が無効になる問題がある。
  2. JDBCドライバプロセス向けに書き出すファイルは、事前に os.open(..., O_WRONLY|O_CREAT, 0o666) で全ユーザー読み取り可能にしておくこと。
  3. Sparkストリーミングのチェックポイントは /Volumes/<catalog>/<schema>/<volume>/... 配下に配置すること。 /Workspace/ 配下・oci:// は不可。
  4. ライブテスト前にAIDPセッショントークンを更新する: oci session authenticate --profile AIDP_SESSION --region us-ashburn-1

参考リンク

原文（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", "Azure SQL", "TDS" aidp-sqlserver
"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

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", "DB2", "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)

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

References

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