@raishin/vanguard-frontier-agentic 3.19.0 → 3.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +8 -1
- package/.cursor-plugin/plugin.json +8 -1
- package/.github/plugin/marketplace.json +1 -1
- package/README.md +21 -21
- package/agents/AGENTS.md +4 -4
- package/agents/README.md +7 -7
- package/agents/alibaba/alibaba-tablestore-architect-agent/AGENT.md +54 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/codex.toml +11 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/metadata.json +39 -0
- package/agents/aws/aws-dynamodb-patterns-agent/AGENT.md +53 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/codex.toml +23 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/copilot.agent.md +42 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/cursor.agent.md +38 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/gemini.agent.md +38 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/aws/aws-dynamodb-patterns-agent/metadata.json +39 -0
- package/agents/azure/azure-cosmosdb-application-developer-agent/metadata.json +4 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/AGENT.md +53 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/codex.toml +23 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/copilot.agent.md +42 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/cursor.agent.md +37 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/gemini.agent.md +38 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/metadata.json +38 -0
- package/agents/gcp/gcp-bigtable-architect-agent/AGENT.md +54 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/codex.toml +11 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/gcp/gcp-bigtable-architect-agent/metadata.json +39 -0
- package/agents/huawei/huawei-geminidb-architect-agent/AGENT.md +54 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/codex.toml +11 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/huawei/huawei-geminidb-architect-agent/metadata.json +38 -0
- package/agents/oci/oci-nosql-database-architect-agent/AGENT.md +54 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/codex.toml +11 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/cursor.agent.md +39 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/oci/oci-nosql-database-architect-agent/metadata.json +39 -0
- package/agents/oci/oci-nosql-pattern-agent/AGENT.md +53 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/codex.toml +23 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/copilot.agent.md +42 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/cursor.agent.md +38 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/gemini.agent.md +38 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/oci/oci-nosql-pattern-agent/metadata.json +38 -0
- package/catalog/agents.json +204 -1
- package/catalog/asset-integrity.json +601 -61
- package/catalog/install-roles.json +19 -1
- package/catalog/model-assignments.json +231 -0
- package/catalog/skill-manifest.json +1603 -56
- package/catalog/skills.json +314 -14
- package/package.json +7 -2
- package/plugins/vanguard-frontier-agentic/.codex-plugin/plugin.json +1 -1
- package/powers/vanguard-alibaba/POWER.md +1 -1
- package/powers/vanguard-aws/POWER.md +1 -1
- package/powers/vanguard-azure/POWER.md +1 -1
- package/powers/vanguard-gcp/POWER.md +1 -1
- package/powers/vanguard-huawei/POWER.md +1 -1
- package/powers/vanguard-oci/POWER.md +1 -1
- package/skills/alibaba/README.md +2 -1
- package/skills/alibaba/alibaba-maestro/SKILL.md +2 -1
- package/skills/alibaba/alibaba-tablestore-architect/SKILL.md +69 -0
- package/skills/alibaba/alibaba-tablestore-architect/metadata.json +28 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/live.md +110 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/offline.md +119 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit.md +22 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/evidence-ledger.md +87 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/operations.md +190 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/tablestore-design-guide.md +159 -0
- package/skills/aws/aws-documentdb-architect/SKILL.md +43 -0
- package/skills/aws/aws-documentdb-architect/metadata.json +26 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit/live.md +135 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit/offline.md +127 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit.md +23 -0
- package/skills/aws/aws-documentdb-architect/references/evidence-ledger.md +52 -0
- package/skills/aws/aws-documentdb-architect/references/official-sources.md +15 -0
- package/skills/aws/aws-documentdb-architect/references/operations.md +165 -0
- package/skills/aws/aws-documentdb-architect/references/safety-checklist.md +22 -0
- package/skills/aws/aws-documentdb-architect/references/workflow-and-output.md +22 -0
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/SKILL.md +5 -3
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/metadata.json +7 -3
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/consistency-indexing-replication.md +103 -0
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/evidence-ledger.md +38 -0
- package/skills/aws/aws-dynamodb-patterns/CHANGELOG.md +87 -0
- package/skills/aws/aws-dynamodb-patterns/README.md +132 -0
- package/skills/aws/aws-dynamodb-patterns/SKILL.md +82 -0
- package/skills/aws/aws-dynamodb-patterns/assets/bedrock-embedding-input.json +6 -0
- package/skills/aws/aws-dynamodb-patterns/assets/content-review.json +6 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table-with-lsi.json +41 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table.json +27 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table.sh +37 -0
- package/skills/aws/aws-dynamodb-patterns/assets/embedding-flow.py +89 -0
- package/skills/aws/aws-dynamodb-patterns/assets/query-input.json +13 -0
- package/skills/aws/aws-dynamodb-patterns/assets/query-pages.mjs +54 -0
- package/skills/aws/aws-dynamodb-patterns/assets/stream-read-policy.json +11 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table-index-read-policy.json +20 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table-resource-policy.json +22 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table.cfn.yaml +55 -0
- package/skills/aws/aws-dynamodb-patterns/assets/typed-vector-item.json +15 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-create-table.json +23 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-search-policy.json +11 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-search.json +10 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-table.cfn.yaml +41 -0
- package/skills/aws/aws-dynamodb-patterns/evals/audit.test.py +87 -0
- package/skills/aws/aws-dynamodb-patterns/evals/backup-restore.test.py +163 -0
- package/skills/aws/aws-dynamodb-patterns/evals/commands.test.py +185 -0
- package/skills/aws/aws-dynamodb-patterns/evals/create-table.test.py +99 -0
- package/skills/aws/aws-dynamodb-patterns/evals/data-vectors-maintenance.test.py +201 -0
- package/skills/aws/aws-dynamodb-patterns/evals/embedding-commands.test.py +162 -0
- package/skills/aws/aws-dynamodb-patterns/evals/embedding-flow.test.py +167 -0
- package/skills/aws/aws-dynamodb-patterns/evals/eval.md +328 -0
- package/skills/aws/aws-dynamodb-patterns/evals/evals.json +185 -0
- package/skills/aws/aws-dynamodb-patterns/evals/modes.test.py +195 -0
- package/skills/aws/aws-dynamodb-patterns/evals/operations.test.py +288 -0
- package/skills/aws/aws-dynamodb-patterns/evals/query-pages.test.mjs +156 -0
- package/skills/aws/aws-dynamodb-patterns/evals/readme-and-loading.test.py +69 -0
- package/skills/aws/aws-dynamodb-patterns/evals/verify.py +166 -0
- package/skills/aws/aws-dynamodb-patterns/metadata.json +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/README.md +32 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit/live.md +64 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit/offline.md +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit.md +65 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/aws-cli.md +206 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup/on-demand.md +36 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup/pitr.md +41 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup.md +27 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/design.md +47 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/embedding.md +200 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/feature-plan.md +56 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/help.md +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/performance-test.md +95 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/recovery-target.md +47 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/refactor.md +82 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore/on-demand.md +32 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore/pitr.md +42 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore.md +76 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/select.md +22 -0
- package/skills/aws/aws-dynamodb-patterns/references/data-types-and-vectors.md +175 -0
- package/skills/aws/aws-dynamodb-patterns/references/embedding-integrations.md +237 -0
- package/skills/aws/aws-dynamodb-patterns/references/encryption.md +156 -0
- package/skills/aws/aws-dynamodb-patterns/references/evidence-index.md +116 -0
- package/skills/aws/aws-dynamodb-patterns/references/evidence-ledger.md +373 -0
- package/skills/aws/aws-dynamodb-patterns/references/iam-and-access.md +173 -0
- package/skills/aws/aws-dynamodb-patterns/references/language-adapters.md +251 -0
- package/skills/aws/aws-dynamodb-patterns/references/lsi-vs-gsi.md +116 -0
- package/skills/aws/aws-dynamodb-patterns/references/maintenance.md +56 -0
- package/skills/aws/aws-dynamodb-patterns/references/modeling.md +131 -0
- package/skills/aws/aws-dynamodb-patterns/references/monitoring.md +137 -0
- package/skills/aws/aws-dynamodb-patterns/references/official-sources.md +34 -0
- package/skills/aws/aws-dynamodb-patterns/references/operations.md +130 -0
- package/skills/aws/aws-dynamodb-patterns/references/provisioning.md +110 -0
- package/skills/aws/aws-dynamodb-patterns/references/recovery-and-replicas.md +148 -0
- package/skills/aws/aws-dynamodb-patterns/references/runtime-contract.md +140 -0
- package/skills/aws/aws-dynamodb-patterns/references/safety-checklist.md +35 -0
- package/skills/aws/aws-dynamodb-patterns/references/sources.md +170 -0
- package/skills/aws/aws-dynamodb-patterns/references/streams-and-dax.md +160 -0
- package/skills/aws/aws-dynamodb-patterns/references/workflow-and-output.md +34 -0
- package/skills/aws/aws-dynamodb-patterns/references/workflow.md +133 -0
- package/skills/aws/aws-dynamodb-patterns/scripts/review_due.py +61 -0
- package/skills/aws/aws-dynamodb-patterns/scripts/select_mode.py +127 -0
- package/skills/aws/aws-keyspaces-architect/SKILL.md +43 -0
- package/skills/aws/aws-keyspaces-architect/metadata.json +26 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit/live.md +118 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit/offline.md +125 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit.md +22 -0
- package/skills/aws/aws-keyspaces-architect/references/evidence-ledger.md +49 -0
- package/skills/aws/aws-keyspaces-architect/references/official-sources.md +15 -0
- package/skills/aws/aws-keyspaces-architect/references/operations.md +154 -0
- package/skills/aws/aws-keyspaces-architect/references/safety-checklist.md +22 -0
- package/skills/aws/aws-keyspaces-architect/references/workflow-and-output.md +22 -0
- package/skills/aws/aws-maestro/SKILL.md +1 -1
- package/skills/aws/aws-maestro/metadata.json +1 -1
- package/skills/aws/aws-maestro/references/workflow-and-output.md +1 -0
- package/skills/azure/azure-cosmosdb-application-developer/SKILL.md +4 -2
- package/skills/azure/azure-cosmosdb-application-developer/metadata.json +1 -1
- package/skills/azure/azure-cosmosdb-pattern/CHANGELOG.md +10 -0
- package/skills/azure/azure-cosmosdb-pattern/README.md +102 -0
- package/skills/azure/azure-cosmosdb-pattern/SKILL.md +69 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/account.arm.json +59 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/content-review.json +9 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/indexing-policy.json +7 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/order.json +10 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/provision.sh +32 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/runtime.mjs +99 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/vector-indexing-policy.json +7 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/vector-policy.json +3 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/eval.md +32 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/fixtures/recovery-continuous.json +28 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/prompts.json +24 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/report.md +54 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/runtime.test.mjs +146 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/source-evidence.json +28 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/test_package.py +355 -0
- package/skills/azure/azure-cosmosdb-pattern/metadata.json +25 -0
- package/skills/azure/azure-cosmosdb-pattern/references/access-control.md +42 -0
- package/skills/azure/azure-cosmosdb-pattern/references/change-feed-and-integrations.md +31 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/live.md +17 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/offline.md +15 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit.md +8 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/azure-cli.md +39 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/continuous.md +30 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/periodic.md +28 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup.md +11 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/design.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/feature-plan.md +18 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/help.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/performance-test.md +24 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/recovery-target.md +30 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/refactor.md +14 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-deleted-resource.md +55 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-new-account.md +50 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/periodic-support.md +27 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/select.md +11 -0
- package/skills/azure/azure-cosmosdb-pattern/references/data-types-and-vectors.md +51 -0
- package/skills/azure/azure-cosmosdb-pattern/references/embedding-integrations.md +56 -0
- package/skills/azure/azure-cosmosdb-pattern/references/encryption.md +53 -0
- package/skills/azure/azure-cosmosdb-pattern/references/evidence-index.md +72 -0
- package/skills/azure/azure-cosmosdb-pattern/references/evidence-ledger.md +174 -0
- package/skills/azure/azure-cosmosdb-pattern/references/indexing-and-capacity.md +37 -0
- package/skills/azure/azure-cosmosdb-pattern/references/language-adapters.md +112 -0
- package/skills/azure/azure-cosmosdb-pattern/references/maintenance.md +19 -0
- package/skills/azure/azure-cosmosdb-pattern/references/modeling.md +44 -0
- package/skills/azure/azure-cosmosdb-pattern/references/monitoring.md +23 -0
- package/skills/azure/azure-cosmosdb-pattern/references/provisioning.md +61 -0
- package/skills/azure/azure-cosmosdb-pattern/references/recovery.md +31 -0
- package/skills/azure/azure-cosmosdb-pattern/references/replication.md +22 -0
- package/skills/azure/azure-cosmosdb-pattern/references/runtime-contract.md +43 -0
- package/skills/azure/azure-cosmosdb-pattern/references/sources.md +61 -0
- package/skills/azure/azure-cosmosdb-pattern/references/workflow.md +18 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/recovery_guard.py +96 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/review_due.py +26 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/select_mode.py +108 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/validate_assets.py +53 -0
- package/skills/azure/azure-cosmosdb-platform-operator/SKILL.md +6 -2
- package/skills/azure/azure-cosmosdb-platform-operator/metadata.json +6 -3
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/live.md +180 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/offline.md +160 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit.md +26 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/consistency-capacity-security.md +136 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/cosmosdb-platform-operations.md +1 -1
- package/skills/azure/azure-cosmosdb-platform-operator/references/evidence-ledger.md +242 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations-cassandra.md +178 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations-mongodb.md +202 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations.md +126 -0
- package/skills/azure/azure-maestro/SKILL.md +1 -0
- package/skills/gcp/README.md +2 -1
- package/skills/gcp/gcp-bigtable-architect/SKILL.md +71 -0
- package/skills/gcp/gcp-bigtable-architect/metadata.json +28 -0
- package/skills/gcp/gcp-bigtable-architect/references/bigtable-design-guide.md +156 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit/live.md +122 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit/offline.md +140 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit.md +21 -0
- package/skills/gcp/gcp-bigtable-architect/references/evidence-ledger.md +83 -0
- package/skills/gcp/gcp-bigtable-architect/references/operations.md +111 -0
- package/skills/gcp/gcp-firebase-developer/SKILL.md +6 -3
- package/skills/gcp/gcp-firebase-developer/metadata.json +14 -4
- package/skills/gcp/gcp-firebase-developer/references/commands/audit/live.md +124 -0
- package/skills/gcp/gcp-firebase-developer/references/commands/audit/offline.md +146 -0
- package/skills/gcp/gcp-firebase-developer/references/commands/audit.md +27 -0
- package/skills/gcp/gcp-firebase-developer/references/evidence-ledger.md +190 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore-mongodb-operations.md +189 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore-operations.md +202 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore.md +122 -0
- package/skills/gcp/gcp-maestro/SKILL.md +2 -1
- package/skills/huawei/README.md +2 -1
- package/skills/huawei/huawei-gaussdb-rds-dba/SKILL.md +7 -4
- package/skills/huawei/huawei-gaussdb-rds-dba/metadata.json +12 -4
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/live.md +68 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/offline.md +106 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit.md +23 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/dds-operations.md +135 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/evidence-ledger.md +87 -0
- package/skills/huawei/huawei-geminidb-architect/SKILL.md +68 -0
- package/skills/huawei/huawei-geminidb-architect/metadata.json +26 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit/live.md +68 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit/offline.md +108 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit.md +23 -0
- package/skills/huawei/huawei-geminidb-architect/references/evidence-ledger.md +83 -0
- package/skills/huawei/huawei-geminidb-architect/references/geminidb-design-guide.md +114 -0
- package/skills/huawei/huawei-geminidb-architect/references/operations.md +135 -0
- package/skills/huawei/huawei-maestro/SKILL.md +2 -1
- package/skills/ionos/ionos-live-database-lifecycle-guard/SKILL.md +2 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/live.md +87 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/offline.md +109 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit.md +27 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/evidence-ledger.md +69 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/mongodb-operations.md +220 -0
- package/skills/oci/README.md +6 -1
- package/skills/oci/oci-nosql-database-architect/SKILL.md +73 -0
- package/skills/oci/oci-nosql-database-architect/metadata.json +28 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit/live.md +136 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit/offline.md +150 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit.md +28 -0
- package/skills/oci/oci-nosql-database-architect/references/evidence-ledger.md +96 -0
- package/skills/oci/oci-nosql-database-architect/references/nosql-design-guide.md +194 -0
- package/skills/oci/oci-nosql-database-architect/references/operations.md +194 -0
- package/skills/oci/oci-nosql-database-architect/references/sdk-matrix.md +43 -0
- package/skills/oci/oci-nosql-pattern/CHANGELOG.md +8 -0
- package/skills/oci/oci-nosql-pattern/README.md +81 -0
- package/skills/oci/oci-nosql-pattern/SKILL.md +62 -0
- package/skills/oci/oci-nosql-pattern/assets/content-review.json +10 -0
- package/skills/oci/oci-nosql-pattern/assets/create-table.sh +32 -0
- package/skills/oci/oci-nosql-pattern/assets/index-keys.json +11 -0
- package/skills/oci/oci-nosql-pattern/assets/migrator-export.json +22 -0
- package/skills/oci/oci-nosql-pattern/assets/migrator-import.json +29 -0
- package/skills/oci/oci-nosql-pattern/assets/orders.ddl +9 -0
- package/skills/oci/oci-nosql-pattern/assets/orders.tf +46 -0
- package/skills/oci/oci-nosql-pattern/assets/query-pages.mjs +33 -0
- package/skills/oci/oci-nosql-pattern/assets/query.json +13 -0
- package/skills/oci/oci-nosql-pattern/assets/query.sql +1 -0
- package/skills/oci/oci-nosql-pattern/assets/recovery-manifest.example.json +35 -0
- package/skills/oci/oci-nosql-pattern/assets/row.json +10 -0
- package/skills/oci/oci-nosql-pattern/assets/table-limits.json +6 -0
- package/skills/oci/oci-nosql-pattern/evals/cli-shapes.json +222 -0
- package/skills/oci/oci-nosql-pattern/evals/eval.md +26 -0
- package/skills/oci/oci-nosql-pattern/evals/prompts.json +89 -0
- package/skills/oci/oci-nosql-pattern/evals/report.md +41 -0
- package/skills/oci/oci-nosql-pattern/evals/test_package.py +350 -0
- package/skills/oci/oci-nosql-pattern/evals/test_runtime.mjs +77 -0
- package/skills/oci/oci-nosql-pattern/metadata.json +25 -0
- package/skills/oci/oci-nosql-pattern/references/access.md +29 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit/live.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit/offline.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit.md +6 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup/migrator.md +12 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup/sdk.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup.md +7 -0
- package/skills/oci/oci-nosql-pattern/references/commands/design.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/feature-plan.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/help.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/performance-test.md +12 -0
- package/skills/oci/oci-nosql-pattern/references/commands/refactor.md +9 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore/migrator.md +13 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore/sdk.md +11 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/select.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/embedding-integrations.md +25 -0
- package/skills/oci/oci-nosql-pattern/references/encryption.md +18 -0
- package/skills/oci/oci-nosql-pattern/references/evidence-index.md +44 -0
- package/skills/oci/oci-nosql-pattern/references/evidence-ledger.md +73 -0
- package/skills/oci/oci-nosql-pattern/references/indexes.md +19 -0
- package/skills/oci/oci-nosql-pattern/references/language-adapters.md +160 -0
- package/skills/oci/oci-nosql-pattern/references/maintenance.md +15 -0
- package/skills/oci/oci-nosql-pattern/references/modeling.md +26 -0
- package/skills/oci/oci-nosql-pattern/references/monitoring.md +21 -0
- package/skills/oci/oci-nosql-pattern/references/provisioning.md +44 -0
- package/skills/oci/oci-nosql-pattern/references/recovery-boundary.md +32 -0
- package/skills/oci/oci-nosql-pattern/references/replicas.md +18 -0
- package/skills/oci/oci-nosql-pattern/references/runtime-contract.md +23 -0
- package/skills/oci/oci-nosql-pattern/references/sources.md +57 -0
- package/skills/oci/oci-nosql-pattern/references/ttl.md +19 -0
- package/skills/oci/oci-nosql-pattern/references/types-and-vectors.md +27 -0
- package/skills/oci/oci-nosql-pattern/scripts/check_recovery.py +52 -0
- package/skills/oci/oci-nosql-pattern/scripts/review_due.py +32 -0
- package/skills/oci/oci-nosql-pattern/scripts/select_mode.py +96 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/SKILL.md +43 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/metadata.json +25 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/live.md +90 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/offline.md +112 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit.md +24 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/evidence-ledger.md +93 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/official-sources.md +15 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/operations.md +216 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/safety-checklist.md +22 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/workflow-and-output.md +22 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/SKILL.md +43 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/metadata.json +24 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/live.md +99 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/offline.md +114 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit.md +24 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/evidence-ledger.md +43 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/official-sources.md +14 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/operations.md +114 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/safety-checklist.md +22 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/workflow-and-output.md +22 -0
- package/templates/nosql-audit-template.md +127 -0
- package/templates/nosql-operations-template.md +60 -0
- package/tests/_generate_maestro_routing_fixtures.py +11 -0
- package/tests/fixtures/README.md +2 -2
- package/tests/fixtures/alibaba-maestro-routing/expected/050-happy-tablestore-partition-key.json +6 -0
- package/tests/fixtures/alibaba-maestro-routing/expected/adv-tablestore-not-polardb.json +6 -0
- package/tests/fixtures/alibaba-maestro-routing/inputs/050-happy-tablestore-partition-key.json +7 -0
- package/tests/fixtures/alibaba-maestro-routing/inputs/adv-tablestore-not-polardb.json +7 -0
- package/tests/fixtures/alibaba-maestro-routing/taxonomy.json +13 -0
- package/tests/fixtures/aws-maestro-routing/expected/042-happy-dynamodb-patterns.json +6 -0
- package/tests/fixtures/aws-maestro-routing/expected/043-happy-dynamodb-vector-index.json +6 -0
- package/tests/fixtures/aws-maestro-routing/inputs/042-happy-dynamodb-patterns.json +7 -0
- package/tests/fixtures/aws-maestro-routing/inputs/043-happy-dynamodb-vector-index.json +7 -0
- package/tests/fixtures/aws-maestro-routing/taxonomy.json +15 -1
- package/tests/fixtures/azure-maestro-routing/expected/028-happy-cosmosdb-pattern-feature-plan.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/029-happy-cosmosdb-pattern-refactor.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-hot-partition-not-key-vault.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-partition-key-not-key-vault.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-throttling-investigation.json +6 -0
- package/tests/fixtures/azure-maestro-routing/inputs/028-happy-cosmosdb-pattern-feature-plan.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/029-happy-cosmosdb-pattern-refactor.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-hot-partition-not-key-vault.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-partition-key-not-key-vault.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-throttling-investigation.json +7 -0
- package/tests/fixtures/azure-maestro-routing/taxonomy.json +21 -2
- package/tests/fixtures/gcp-maestro-routing/expected/049-happy-bigtable-row-key.json +6 -0
- package/tests/fixtures/gcp-maestro-routing/expected/adv-bigtable-not-firestore.json +8 -0
- package/tests/fixtures/gcp-maestro-routing/inputs/049-happy-bigtable-row-key.json +7 -0
- package/tests/fixtures/gcp-maestro-routing/inputs/adv-bigtable-not-firestore.json +7 -0
- package/tests/fixtures/gcp-maestro-routing/taxonomy.json +15 -0
- package/tests/fixtures/huawei-maestro-routing/expected/050-happy-geminidb-cassandra-partition.json +6 -0
- package/tests/fixtures/huawei-maestro-routing/expected/adv-geminidb-mongo-routes-dds.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/inputs/050-happy-geminidb-cassandra-partition.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/inputs/adv-geminidb-mongo-routes-dds.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/taxonomy.json +15 -0
- package/tests/fixtures/nosql-scenarios/scenarios.json +472 -0
- package/tests/fixtures/oci-maestro-routing/expected/031-happy-nosql-database-architect.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/032-happy-nosql-global-active-table.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/033-happy-nosql-pattern-recovery.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/034-happy-nosql-pattern-refactor.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-live-mutation.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-not-autonomous.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/031-happy-nosql-database-architect.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/032-happy-nosql-global-active-table.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/033-happy-nosql-pattern-recovery.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/034-happy-nosql-pattern-refactor.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-live-mutation.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-not-autonomous.json +7 -0
- package/tests/fixtures/oci-maestro-routing/taxonomy.json +27 -0
- package/tests/requirements-ci.txt +8 -0
- package/tests/validate-aws-skill-quality.py +7 -0
- package/tests/validate-nosql-audit.py +741 -0
- package/tests/validate-nosql-operations.py +136 -0
- package/tests/validate-nosql-pattern-evals.py +96 -0
- package/tests/validate-nosql-scenarios.py +94 -0
- package/tests/validate-skill-manifest.py +6 -1
- package/tests/validate-skill-references.py +225 -0
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
# Oracle NoSQL Database Cloud Service design guide
|
|
2
|
+
|
|
3
|
+
Load this for table, key, consistency, capacity, limits, TTL, child-table,
|
|
4
|
+
Global Active table, backup or IAM questions. Every bracketed ID resolves in
|
|
5
|
+
[evidence-ledger.md](evidence-ledger.md). Anything without an ID is labeled
|
|
6
|
+
**inference** or **recommendation** and must be presented that way.
|
|
7
|
+
|
|
8
|
+
Do not import DynamoDB or Cosmos DB vocabulary. NDCS has *shard keys* (not
|
|
9
|
+
partition keys); *read units and write units*, which Oracle abbreviates RU and
|
|
10
|
+
WU but which are not DynamoDB RCUs/WCUs or Cosmos DB Request Units; and
|
|
11
|
+
*Global Active tables* (not DynamoDB global tables). Their guarantees differ.
|
|
12
|
+
|
|
13
|
+
## Capability matrix
|
|
14
|
+
|
|
15
|
+
| Area | Status | What is verified | Evidence |
|
|
16
|
+
| --- | --- | --- | --- |
|
|
17
|
+
| Data model | SUPPORTED | Fixed-schema tables and schema-less JSON columns | [OCI-NOSQL-E14] |
|
|
18
|
+
| Primary / shard key | SUPPORTED | Shard key is a portion of the primary key; both are immutable after creation | [OCI-NOSQL-E02] [OCI-NOSQL-E04] |
|
|
19
|
+
| Read consistency | SUPPORTED | EVENTUAL or ABSOLUTE, per handle or per read; ABSOLUTE costs 2x read units | [OCI-NOSQL-E03] |
|
|
20
|
+
| Transactions | CONDITIONAL | ACID only across records sharing a shard key (or one parent-child hierarchy) | [OCI-NOSQL-E05] [OCI-NOSQL-E08] |
|
|
21
|
+
| Capacity | CONDITIONAL | Provisioned or On-Demand; 1 KB units; hard per-table caps; mode switch once per day | [OCI-NOSQL-E01] [OCI-NOSQL-E15] [OCI-NOSQL-E23] |
|
|
22
|
+
| Table limits | SUPPORTED | 5 indexes/table, 512 KB rows, 30 tables/region | [OCI-NOSQL-E24] |
|
|
23
|
+
| TTL | SUPPORTED | Table default plus per-row override, HOURS or DAYS | [OCI-NOSQL-E07] |
|
|
24
|
+
| Parent-child tables | SUPPORTED | Shared shard key, inherited primary key, no referential integrity | [OCI-NOSQL-E08] |
|
|
25
|
+
| Multi-region | CONDITIONAL | Global Active tables: async active-active, latest-timestamp wins, frozen schema; not in dedicated hosted environments | [OCI-NOSQL-E09] [OCI-NOSQL-E10] [OCI-NOSQL-E12] [OCI-NOSQL-E30] |
|
|
26
|
+
| Backup / restore | CONDITIONAL | Customer-run, via Oracle's migrator tool to Object Storage | [OCI-NOSQL-E30] |
|
|
27
|
+
| IAM | SUPPORTED | Verb-to-permission mapping on `nosql-rows`, `nosql-tables`, `nosql-indexes`; table-name scoping | [OCI-NOSQL-E13] [OCI-NOSQL-E29] |
|
|
28
|
+
| SDKs | CONDITIONAL | Java, Python, Node.js, Go, .NET verified; Spring Data and Rust repos exist but details unverified | [OCI-NOSQL-E16] [OCI-NOSQL-E21] [OCI-NOSQL-E32] [OCI-NOSQL-E33] |
|
|
29
|
+
| Private networking | CONDITIONAL | Service gateway path from a VCN (solution page); no NDCS-specific private endpoint found | [OCI-NOSQL-E34] [OCI-NOSQL-E22] |
|
|
30
|
+
| Customer-managed keys | CONDITIONAL | Dedicated environment only; AES-256 in OCI KMS; single-version keys only | [OCI-NOSQL-E35] |
|
|
31
|
+
| Pricing, quota increases | UNVERIFIED | Not found this pass; do not assert | [OCI-NOSQL-E22] |
|
|
32
|
+
|
|
33
|
+
## Key design
|
|
34
|
+
|
|
35
|
+
The primary key and shard key are permanent [OCI-NOSQL-E04]. Treat key design
|
|
36
|
+
as a one-way door: a wrong shard key means a new table plus a data migration,
|
|
37
|
+
not an ALTER. That alone justifies refusing to approve a schema without an
|
|
38
|
+
access-pattern list. *(inference from E04)*
|
|
39
|
+
|
|
40
|
+
Shard key decision checklist [OCI-NOSQL-E05]:
|
|
41
|
+
|
|
42
|
+
1. **Cardinality** — high-cardinality identifiers (`customerID`, `userID`)
|
|
43
|
+
spread data; low-cardinality fields (country, status) create hot shards.
|
|
44
|
+
2. **Atomicity** — if a business operation must commit several records
|
|
45
|
+
atomically, those records must share a shard key. This pulls toward
|
|
46
|
+
*coarser* shard keys and directly conflicts with cardinality. Name the
|
|
47
|
+
trade-off explicitly; do not paper over it.
|
|
48
|
+
3. **Uniform distribution** — no single shard should cap system capacity.
|
|
49
|
+
4. **Query isolation** — a query that does not target one shard runs on all
|
|
50
|
+
shards. Make the frequent queries shard-targeted.
|
|
51
|
+
|
|
52
|
+
If no shard key is declared, the full primary key is used [OCI-NOSQL-E06].
|
|
53
|
+
That gives the widest distribution and the narrowest transaction scope.
|
|
54
|
+
*(inference)*
|
|
55
|
+
|
|
56
|
+
**Parent-child tables** model 1:N relationships with ACID writes across the
|
|
57
|
+
hierarchy [OCI-NOSQL-E08]. Referential integrity is not enforced and a parent
|
|
58
|
+
cannot be dropped before its children [OCI-NOSQL-E08], so orphan prevention is
|
|
59
|
+
the application's job. *(inference)*
|
|
60
|
+
|
|
61
|
+
## Consistency
|
|
62
|
+
|
|
63
|
+
| Need | Choose | Cost | Evidence |
|
|
64
|
+
| --- | --- | --- | --- |
|
|
65
|
+
| Read-your-latest-write for a key in this region | ABSOLUTE | 2x read units | [OCI-NOSQL-E03] |
|
|
66
|
+
| Latency/cost-sensitive reads that tolerate staleness | EVENTUAL | 1x read units | [OCI-NOSQL-E03] |
|
|
67
|
+
| Latest value across regions on a Global Active table | **Not available** — remote updates are always eventually consistent | — | [OCI-NOSQL-E10] |
|
|
68
|
+
|
|
69
|
+
Set consistency per read for the few reads that need ABSOLUTE rather than on
|
|
70
|
+
the handle for everything; the handle-wide setting doubles every read's cost
|
|
71
|
+
[OCI-NOSQL-E03]. *(recommendation)*
|
|
72
|
+
|
|
73
|
+
## Capacity, limits and cost
|
|
74
|
+
|
|
75
|
+
- Units are 1 KB granular: a read unit is up to 1 KB/s of eventually
|
|
76
|
+
consistent reads, a write unit up to 1 KB/s of writes [OCI-NOSQL-E15].
|
|
77
|
+
Row size, not row count, drives units. ABSOLUTE reads double the read
|
|
78
|
+
figure [OCI-NOSQL-E03].
|
|
79
|
+
- **Writes can cost reads.** Conditional puts (IfAbsent/IfPresent), UPDATE
|
|
80
|
+
statements and deletes consume read units at the absolute (x2) rate in
|
|
81
|
+
addition to write units [OCI-NOSQL-E25]. A write-heavy workload with
|
|
82
|
+
conditional writes needs read capacity too.
|
|
83
|
+
- **Index updates consume write units** [OCI-NOSQL-E15], and a table may have
|
|
84
|
+
at most 5 indexes [OCI-NOSQL-E24]. Each index is a standing write cost and a
|
|
85
|
+
scarce slot; the default answer to "add an index?" is "show the query that
|
|
86
|
+
needs it." *(recommendation)*
|
|
87
|
+
- Rows are capped at 512 KB [OCI-NOSQL-E24]; a growing JSON document needs a
|
|
88
|
+
child table or splitting before it hits that ceiling. *(recommendation)*
|
|
89
|
+
- **Hard per-table ceilings** [OCI-NOSQL-E23]: Provisioned up to 40,000 read
|
|
90
|
+
and 20,000 write units; On-Demand only up to 10,000 read and 5,000 write
|
|
91
|
+
units, and only 3 On-Demand tables per region. A table that may exceed the
|
|
92
|
+
On-Demand ceiling must be Provisioned.
|
|
93
|
+
- **Mode switches are rationed** [OCI-NOSQL-E23]: capacity mode can change
|
|
94
|
+
only once per day, and limits can decrease at most four times per 24 hours
|
|
95
|
+
(increases are unlimited). A failover or cost plan that flips mode or shrinks
|
|
96
|
+
capacity repeatedly will fail. Size for peak, then scale down deliberately.
|
|
97
|
+
- Prices and quota increases are volatile and were not retrieved
|
|
98
|
+
[OCI-NOSQL-E22]. Any cost estimate must cite a pricing page fetched at the
|
|
99
|
+
time of the estimate, or be labeled an assumption. Do not use
|
|
100
|
+
hosted-environment totals: the source contradicts itself [OCI-NOSQL-E31].
|
|
101
|
+
|
|
102
|
+
## TTL
|
|
103
|
+
|
|
104
|
+
Table TTL defaults to zero (never expire), takes HOURS or DAYS, and a row TTL
|
|
105
|
+
overrides the table value [OCI-NOSQL-E07]. Expired rows stop being retrievable
|
|
106
|
+
and are later purged from disk [OCI-NOSQL-E07], but no purge timing is given.
|
|
107
|
+
Do not use TTL as an exact business-deletion deadline (for example legal
|
|
108
|
+
erasure) unless purge timing has been verified separately. *(inference)*
|
|
109
|
+
|
|
110
|
+
## Backup and restore
|
|
111
|
+
|
|
112
|
+
Backup and restore are the **customer's** responsibility, using Oracle's
|
|
113
|
+
migrator tool and Object Storage [OCI-NOSQL-E30]. Treat "the cloud backs it up"
|
|
114
|
+
as a defect. A design is not READY without a scheduled export, a tested
|
|
115
|
+
restore and a stated RPO/RTO. *(recommendation)* A restore writes to a table,
|
|
116
|
+
so it is a mutation under the approval rules in `SKILL.md`.
|
|
117
|
+
|
|
118
|
+
## Global Active tables
|
|
119
|
+
|
|
120
|
+
Use for regional DR or local-latency reads with active-active writes
|
|
121
|
+
[OCI-NOSQL-E09]. They are not available in a dedicated hosted environment
|
|
122
|
+
[OCI-NOSQL-E30]. Before approving, confirm all of:
|
|
123
|
+
|
|
124
|
+
- [ ] The schema is frozen (`with schema frozen`, or `with schema frozen force`
|
|
125
|
+
if there are no JSON columns) [OCI-NOSQL-E12]. Any later schema change
|
|
126
|
+
means **dropping all replicas, altering, and re-adding them**
|
|
127
|
+
[OCI-NOSQL-E26]. That is a multi-region production change. Include at
|
|
128
|
+
least one JSON column, as Oracle recommends, to avoid it [OCI-NOSQL-E26].
|
|
129
|
+
- [ ] The application tolerates **latest-timestamp-wins** conflict resolution
|
|
130
|
+
[OCI-NOSQL-E09]. Counters, balances and inventory decrements written in
|
|
131
|
+
two regions will lose updates. *(inference)* Route those writes to one
|
|
132
|
+
home region or redesign them.
|
|
133
|
+
- [ ] Nothing depends on cross-region transactions or cross-region ABSOLUTE
|
|
134
|
+
reads; both are region-local [OCI-NOSQL-E10].
|
|
135
|
+
- [ ] Global keys do not use identity columns, which Oracle advises against in
|
|
136
|
+
most cases because they are not unique across replicas [OCI-NOSQL-E11].
|
|
137
|
+
- [ ] Child tables are planned: a child of a Global Active table is a
|
|
138
|
+
singleton unless its schema is frozen and a replica is added to it too
|
|
139
|
+
[OCI-NOSQL-E27].
|
|
140
|
+
- [ ] The receiver region has the same-name compartment, no same-name table,
|
|
141
|
+
and the replica's IAM grants are planned [OCI-NOSQL-E11].
|
|
142
|
+
- [ ] Each region's write capacity covers replicated incoming writes, which are
|
|
143
|
+
billed [OCI-NOSQL-E25], and failover peak load. Remember mode switches
|
|
144
|
+
are once per day [OCI-NOSQL-E23]. *(recommendation)*
|
|
145
|
+
|
|
146
|
+
## IAM least privilege
|
|
147
|
+
|
|
148
|
+
| Workload | Statement | Grants | Evidence |
|
|
149
|
+
| --- | --- | --- | --- |
|
|
150
|
+
| Read-only service or report | `read nosql-rows` | NOSQL_ROWS_READ | [OCI-NOSQL-E13] |
|
|
151
|
+
| Writer that never deletes | `use nosql-rows` | + NOSQL_ROWS_INSERT | [OCI-NOSQL-E13] |
|
|
152
|
+
| Writer that deletes | `manage nosql-rows` | + NOSQL_ROWS_DELETE | [OCI-NOSQL-E13] |
|
|
153
|
+
| Capacity / schema operator | `use nosql-tables` | + NOSQL_TABLE_ALTER (limits, ALTER TABLE) | [OCI-NOSQL-E29] |
|
|
154
|
+
| Table lifecycle | `manage nosql-tables` | + NOSQL_TABLE_CREATE, NOSQL_TABLE_DROP | [OCI-NOSQL-E29] |
|
|
155
|
+
| Index lifecycle | `manage nosql-indexes` | index create/drop | [OCI-NOSQL-E13] |
|
|
156
|
+
|
|
157
|
+
Rules:
|
|
158
|
+
|
|
159
|
+
- Application identities get `nosql-rows` verbs only: `read`, `use`, or
|
|
160
|
+
`manage nosql-rows` when the application must delete rows [OCI-NOSQL-E13].
|
|
161
|
+
Keep every `nosql-tables` and `nosql-indexes` verb off application
|
|
162
|
+
identities, because even `use nosql-tables` allows ALTER TABLE and limit
|
|
163
|
+
changes [OCI-NOSQL-E29]. *(recommendation)*
|
|
164
|
+
- Scope to a compartment, never the tenancy, and narrow to one table with
|
|
165
|
+
`target.nosql-table.name` where possible [OCI-NOSQL-E29].
|
|
166
|
+
- On Global Active tables, row permissions are **per region** and do not stop
|
|
167
|
+
replication: a write allowed in one region reaches every replica regardless
|
|
168
|
+
of the receiving region's permissions [OCI-NOSQL-E28]. The effective write
|
|
169
|
+
policy is the most permissive region's. *(inference)*
|
|
170
|
+
- Replica add/drop needs NOSQL_TABLE_ALTER in the sender and every receiver
|
|
171
|
+
region, plus NOSQL_TABLE_CREATE or NOSQL_TABLE_DROP in the target receiver
|
|
172
|
+
[OCI-NOSQL-E28].
|
|
173
|
+
- Policy statements must use real group and compartment names supplied by the
|
|
174
|
+
user; never invent them.
|
|
175
|
+
|
|
176
|
+
## When to push back
|
|
177
|
+
|
|
178
|
+
- Shard key proposed without the access patterns and the atomicity
|
|
179
|
+
requirement.
|
|
180
|
+
- Low-cardinality shard key (tenant, status, country, date bucket).
|
|
181
|
+
- "Use ABSOLUTE everywhere to be safe" without a cost line.
|
|
182
|
+
- On-Demand for a table whose peak may exceed 10,000 read or 5,000 write units
|
|
183
|
+
[OCI-NOSQL-E23].
|
|
184
|
+
- A plan that relies on switching capacity mode more than once a day
|
|
185
|
+
[OCI-NOSQL-E23].
|
|
186
|
+
- Global Active table for multi-region counters or read-modify-write without a
|
|
187
|
+
home-region write rule, or for a dedicated hosted environment
|
|
188
|
+
[OCI-NOSQL-E30].
|
|
189
|
+
- No backup schedule or untested restore [OCI-NOSQL-E30].
|
|
190
|
+
- Any claim about an NDCS private endpoint, pricing or quota increases without a
|
|
191
|
+
freshly retrieved source [OCI-NOSQL-E22].
|
|
192
|
+
- CMEK planned on a shared (non-dedicated) environment, or a key rotation plan
|
|
193
|
+
that relies on multi-version keys [OCI-NOSQL-E35].
|
|
194
|
+
- Confusing NDCS with Autonomous Database or Oracle Database JSON features.
|
|
@@ -0,0 +1,194 @@
|
|
|
1
|
+
# Oracle NoSQL Database Cloud Service operations
|
|
2
|
+
|
|
3
|
+
Operational coverage for Oracle NoSQL Database Cloud Service (NDCS) on OCI. This is
|
|
4
|
+
not Autonomous Database and not on-premises Oracle NoSQL Database. Every section uses the
|
|
5
|
+
same heading and states one status. Cite evidence rows from
|
|
6
|
+
[the evidence ledger](evidence-ledger.md) as `[OCI-NOSQL-Exx]`.
|
|
7
|
+
`tests/validate-nosql-operations.py` enforces this structure.
|
|
8
|
+
|
|
9
|
+
Statuses:
|
|
10
|
+
|
|
11
|
+
- `VERIFIED`: the provider documents the capability; every statement below cites a
|
|
12
|
+
VERIFIED row.
|
|
13
|
+
- `PARTIAL`: some of it is documented and some is not, or it is limited (by tier,
|
|
14
|
+
mode, Region or API); say which part is which.
|
|
15
|
+
- `UNSUPPORTED`: provider documentation states the capability does not exist. Cite it.
|
|
16
|
+
- `UNVERIFIED`: no official page settled it in this pass. Say what was searched.
|
|
17
|
+
- `NOT APPLICABLE`: the capability does not apply to this service. Say why.
|
|
18
|
+
|
|
19
|
+
## Backup and restore
|
|
20
|
+
|
|
21
|
+
**Status:** PARTIAL
|
|
22
|
+
|
|
23
|
+
- Documented (VERIFIED): backup and restore are the customer's job. Oracle supplies
|
|
24
|
+
the NoSQL Database Migrator, which can export a table to OCI Object Storage and
|
|
25
|
+
restore a table from those files. [OCI-NOSQL-E30] [OCI-NOSQL-E101]
|
|
26
|
+
- Oracle's own example copies a table to a JSON file in Object Storage for periodic
|
|
27
|
+
backups, run from Cloud Shell. The schedule is yours to build. [OCI-NOSQL-E102]
|
|
28
|
+
- Restore target: the migrator writes into a sink table. If the sink table exists with
|
|
29
|
+
a different schema the migration fails; with the same schema, rows with matching
|
|
30
|
+
primary keys are overwritten when the overwrite setting is true. [OCI-NOSQL-E102]
|
|
31
|
+
- Not documented (UNVERIFIED): any native on-demand, scheduled or point-in-time
|
|
32
|
+
backup, retention limit, or statement of what a restore leaves out (indexes, TTL,
|
|
33
|
+
IAM policies, tags). Searched the Features, Plan, Global Active, Monitor, Policies,
|
|
34
|
+
migrator, What's New and release-notes pages. [OCI-NOSQL-E126]
|
|
35
|
+
- Design consequence: treat any exported file set as the only recovery copy, secure
|
|
36
|
+
the Object Storage bucket, and test a restore into a scratch table.
|
|
37
|
+
Global Active replicas are redundancy, not backups: a bad write replicates. [OCI-NOSQL-E28]
|
|
38
|
+
|
|
39
|
+
## Disaster recovery and replication
|
|
40
|
+
|
|
41
|
+
**Status:** PARTIAL
|
|
42
|
+
|
|
43
|
+
- Inside a region, data is stored across multiple Availability Domains, or Fault
|
|
44
|
+
Domains in single-AD regions, so a single AD or FD loss leaves data reachable.
|
|
45
|
+
[OCI-NOSQL-E103]
|
|
46
|
+
- Cross-region: Global Active tables replicate active-active and asynchronously;
|
|
47
|
+
concurrent conflicts resolve by latest timestamp. [OCI-NOSQL-E09]
|
|
48
|
+
- Failover mode: when a region is unavailable, the application requests are redirected
|
|
49
|
+
to a region holding a replica, where reads and writes continue; the failed
|
|
50
|
+
region resynchronizes on return. No service-driven automatic failover switch is
|
|
51
|
+
documented, so the redirect is application or DNS logic you own. [OCI-NOSQL-E104]
|
|
52
|
+
- ACID transactions and ABSOLUTE consistency are local to one region; data replicated
|
|
53
|
+
from another region is read as eventually consistent. [OCI-NOSQL-E10]
|
|
54
|
+
- Lag is observable (Replica Lag metric) but the pages searched state no RPO or RTO
|
|
55
|
+
figure (UNVERIFIED); do not promise one. [OCI-NOSQL-E105] [OCI-NOSQL-E114] [OCI-NOSQL-E126]
|
|
56
|
+
- Limits: a dedicated hosted environment does not support Global Active tables, and a
|
|
57
|
+
schema change after replicas exist needs all replicas dropped first.
|
|
58
|
+
[OCI-NOSQL-E30] [OCI-NOSQL-E26]
|
|
59
|
+
|
|
60
|
+
## Cost
|
|
61
|
+
|
|
62
|
+
**Status:** VERIFIED
|
|
63
|
+
|
|
64
|
+
Billing dimensions only (what is billed and how it scales). Official pricing page:
|
|
65
|
+
<https://www.oracle.com/database/nosql/pricing/> and the Cost Estimator on the Oracle
|
|
66
|
+
Cloud website. Never write unit prices or currency amounts here.
|
|
67
|
+
|
|
68
|
+
- Capacity modes: Provisioned Capacity (fixed read/write throughput and storage) or
|
|
69
|
+
On-Demand Capacity (Oracle manages read/write capacity, storage still limited); a
|
|
70
|
+
dedicated hosted environment is a third, flat-fee option. [OCI-NOSQL-E01] [OCI-NOSQL-E107]
|
|
71
|
+
- Dimensions: read units, write units and GB of storage per month. A write unit covers
|
|
72
|
+
up to 1 KB per second, index updates consume write units, and ABSOLUTE reads consume
|
|
73
|
+
twice the read units of EVENTUAL. [OCI-NOSQL-E15] [OCI-NOSQL-E03] [OCI-NOSQL-E108]
|
|
74
|
+
- Hidden consumers: conditional puts, query-based updates and deletes consume read
|
|
75
|
+
units as well as write units. [OCI-NOSQL-E25]
|
|
76
|
+
- Replication: a Global Active table adds a second component, incoming replicated
|
|
77
|
+
writes at each regional replica, charged on writes consumed. [OCI-NOSQL-E106]
|
|
78
|
+
[OCI-NOSQL-E25]
|
|
79
|
+
- Dedicated hosted environment: one monthly price for the whole environment instead
|
|
80
|
+
of per-unit charges. [OCI-NOSQL-E107]
|
|
81
|
+
- Autoscale or on-demand invoices reflect actual consumption; log the units returned
|
|
82
|
+
by each API call to reconcile. [OCI-NOSQL-E108]
|
|
83
|
+
- Guardrails: compartment quotas on read units, write units and table size, and
|
|
84
|
+
per-table limits (including at most four capacity decreases per 24 hours).
|
|
85
|
+
[OCI-NOSQL-E116] [OCI-NOSQL-E23]
|
|
86
|
+
|
|
87
|
+
## Monitoring
|
|
88
|
+
|
|
89
|
+
**Status:** VERIFIED
|
|
90
|
+
|
|
91
|
+
- Service: OCI Monitoring; namespace `oci_nosql`; dimensions `resourceId` and
|
|
92
|
+
`tableName`. [OCI-NOSQL-E110]
|
|
93
|
+
- Metrics: `ReadUnits`, `WriteUnits`, `StorageGB`, `ReadThrottleCount`,
|
|
94
|
+
`WriteThrottleCount`, `StorageThrottleCount`, `MaxShardSizeUsagePercent`, and
|
|
95
|
+
Replica Lag (extra dimension `replica`, milliseconds). [OCI-NOSQL-E110] [OCI-NOSQL-E114]
|
|
96
|
+
- Recommended alarm: `MaxShardSizeUsagePercent` at about 90 percent, notified through
|
|
97
|
+
OCI Notifications. Alarm on the throttle counts too (an inference from the
|
|
98
|
+
documented meaning of those metrics). [OCI-NOSQL-E111] [OCI-NOSQL-E112]
|
|
99
|
+
- Events: table actions (create, drop, alter, index, replica, compartment move) emit
|
|
100
|
+
OCI Events for rules and notifications. [OCI-NOSQL-E115]
|
|
101
|
+
- Caveat: StorageGB is truncated and refreshed with delay; under 1 GB can show as 0.
|
|
102
|
+
[OCI-NOSQL-E110]
|
|
103
|
+
|
|
104
|
+
## Performance
|
|
105
|
+
|
|
106
|
+
**Status:** VERIFIED
|
|
107
|
+
|
|
108
|
+
- Throttling signal: a throttling exception usually means the provisioned throughput
|
|
109
|
+
was exceeded; if frequent, raise Read Units, Write Units or storage. Watch the three
|
|
110
|
+
throttle-count metrics. [OCI-NOSQL-E112] [OCI-NOSQL-E110]
|
|
111
|
+
- Hot shards: data is sharded on the shard key. Low-cardinality keys cause hot
|
|
112
|
+
shards. [OCI-NOSQL-E02] [OCI-NOSQL-E05]
|
|
113
|
+
- Storage hotspot: when `MaxShardSizeUsagePercent` reaches 100, writes stop even if
|
|
114
|
+
allocated storage is not used up. Pick a high-cardinality shard key and limit child
|
|
115
|
+
tables, since a hierarchy shares one shard key. [OCI-NOSQL-E113] [OCI-NOSQL-E08]
|
|
116
|
+
- Limits that bind: per-table read/write units (provisioned and on-demand maxima),
|
|
117
|
+
5 indexes per table, 512 KB per row, 4 DDL operations per minute per region.
|
|
118
|
+
[OCI-NOSQL-E23] [OCI-NOSQL-E24]
|
|
119
|
+
- ABSOLUTE consistency costs double the read units. [OCI-NOSQL-E03]
|
|
120
|
+
|
|
121
|
+
## IAM
|
|
122
|
+
|
|
123
|
+
**Status:** VERIFIED
|
|
124
|
+
|
|
125
|
+
- Model: OCI IAM policies (groups, dynamic groups, compartments). Three NoSQL resource
|
|
126
|
+
types: `nosql-tables` (table DDL and limits), `nosql-rows` (data) and `nosql-indexes`.
|
|
127
|
+
Verbs are cumulative: inspect, read, use, manage. [OCI-NOSQL-E117]
|
|
128
|
+
- Control plane versus data plane: `nosql-tables` USE adds ALTER (UpdateTable,
|
|
129
|
+
change TableLimits); MANAGE adds create and drop. `nosql-rows` READ allows get and
|
|
130
|
+
SELECT, USE adds insert and update, MANAGE adds delete. [OCI-NOSQL-E29] [OCI-NOSQL-E13]
|
|
131
|
+
- Least privilege: scope statements to a compartment and to one table with
|
|
132
|
+
`target.nosql-table.name` or `target.nosql-table.id`. Give applications `nosql-rows`
|
|
133
|
+
rights only; keep `nosql-tables` MANAGE with administrators. [OCI-NOSQL-E117] [OCI-NOSQL-E29]
|
|
134
|
+
- Workloads on OCI use instance or resource principals, which need a dynamic group
|
|
135
|
+
and policy first. [OCI-NOSQL-E118]
|
|
136
|
+
- Global Active tables replicate changes regardless of user permission, and adding or
|
|
137
|
+
dropping replicas needs ALTER in every region involved. [OCI-NOSQL-E28]
|
|
138
|
+
|
|
139
|
+
## Tagging
|
|
140
|
+
|
|
141
|
+
**Status:** PARTIAL
|
|
142
|
+
|
|
143
|
+
- Supported (VERIFIED): OCI tags attach to a Global Active table, and tags are not
|
|
144
|
+
replicated, so each region's replica carries its own. [OCI-NOSQL-E119]
|
|
145
|
+
- Table events carry `freeformTags` in their payload. [OCI-NOSQL-E115]
|
|
146
|
+
- Not documented (UNVERIFIED): tag-based access control. The policy reference lists
|
|
147
|
+
only `target.nosql-table.id` and `target.nosql-table.name` as NoSQL variables, so
|
|
148
|
+
name- or OCID-based scoping is the documented route. [OCI-NOSQL-E117]
|
|
149
|
+
- Defined-tag namespaces, tag defaults and cost-tracking behaviour for NoSQL tables
|
|
150
|
+
were not confirmed in this pass. [OCI-NOSQL-E126]
|
|
151
|
+
|
|
152
|
+
## Encryption
|
|
153
|
+
|
|
154
|
+
**Status:** VERIFIED
|
|
155
|
+
|
|
156
|
+
- At rest: data is encrypted on disk with AES 256 under an Oracle-managed master key
|
|
157
|
+
by default. [OCI-NOSQL-E120] [OCI-NOSQL-E35]
|
|
158
|
+
- Customer-managed keys: CMEK only in a dedicated environment. The key lives in an OCI
|
|
159
|
+
KMS vault, must be AES-256 symmetric, and only single-version keys are supported;
|
|
160
|
+
backups of that environment in Object Storage use the same key. [OCI-NOSQL-E35]
|
|
161
|
+
- Key state changes are logged by OCI Audit, and an `EncryptionKeyStatus` metric
|
|
162
|
+
supports alarms. [OCI-NOSQL-E122]
|
|
163
|
+
- In transit: HTTPS; Oracle states connections require TLS 1.2 and wallet-based
|
|
164
|
+
authentication. [OCI-NOSQL-E120] [OCI-NOSQL-E121]
|
|
165
|
+
|
|
166
|
+
## Network isolation
|
|
167
|
+
|
|
168
|
+
**Status:** PARTIAL
|
|
169
|
+
|
|
170
|
+
- Documented (VERIFIED): a service gateway gives a VCN private access to supported
|
|
171
|
+
Oracle services over the Oracle network fabric, without internet traffic. An Oracle
|
|
172
|
+
reference architecture uses it for NDCS. [OCI-NOSQL-E123] [OCI-NOSQL-E34]
|
|
173
|
+
- Not documented (UNVERIFIED): an NDCS-specific private endpoint, a setting that
|
|
174
|
+
disables the public endpoint, or IP allow-listing. Earlier and current searches found
|
|
175
|
+
none. Do not claim them. [OCI-NOSQL-E22] [OCI-NOSQL-E126]
|
|
176
|
+
- Workaround to design for: private subnet, service gateway route, IAM scoping and
|
|
177
|
+
TLS; the endpoint stays a public regional name otherwise. This is judgment, not a
|
|
178
|
+
documented guarantee. [OCI-NOSQL-E121]
|
|
179
|
+
- Dedicated hosted environments get their own endpoint name, but the page does not
|
|
180
|
+
describe it as private. [OCI-NOSQL-E30]
|
|
181
|
+
|
|
182
|
+
## Audit logging
|
|
183
|
+
|
|
184
|
+
**Status:** PARTIAL
|
|
185
|
+
|
|
186
|
+
- Control plane (VERIFIED): Oracle states it logs DDL API calls on NoSQL tables and
|
|
187
|
+
makes the logs available to you; OCI Audit records supported public API calls as
|
|
188
|
+
events. [OCI-NOSQL-E124] [OCI-NOSQL-E125]
|
|
189
|
+
- Events service adds create, drop, alter, index and replica events for rules and
|
|
190
|
+
alerts. [OCI-NOSQL-E115]
|
|
191
|
+
- Data plane (UNVERIFIED): no page states whether row operations (get, put, query)
|
|
192
|
+
appear in OCI Audit. Do not assume row-level auditing; log access in the
|
|
193
|
+
application. [OCI-NOSQL-E125] [OCI-NOSQL-E126]
|
|
194
|
+
- CMEK key state changes are audited in dedicated environments. [OCI-NOSQL-E122]
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# Oracle NoSQL SDK compatibility matrix
|
|
2
|
+
|
|
3
|
+
Load this only when the task involves application code. These are the
|
|
4
|
+
**Oracle NoSQL SDKs**. Do not substitute Oracle Database drivers (JDBC,
|
|
5
|
+
`python-oracledb`, `node-oracledb`). They target a different product.
|
|
6
|
+
|
|
7
|
+
"Documentation-verified" means the package name and API shape were read from
|
|
8
|
+
the provider's README or docs on the retrieval date. No example below was
|
|
9
|
+
compiled or executed in this repository.
|
|
10
|
+
|
|
11
|
+
| Language | Package | Runtime | Client / auth entry point | Status | Evidence |
|
|
12
|
+
| --- | --- | --- | --- | --- | --- |
|
|
13
|
+
| Java | Maven `com.oracle.nosql.sdk:nosqldriver` | Java 11+ | `NoSQLHandleConfig` + `SignatureProvider`, `NoSQLHandleFactory.createNoSQLHandle` | documentation-verified | [OCI-NOSQL-E17] [OCI-NOSQL-E20] |
|
|
14
|
+
| Python | `borneo` (+ `oci` for the cloud service) | Python 3.12+ | `NoSQLHandle(NoSQLHandleConfig(endpoint, provider))`, `borneo.iam.SignatureProvider` | documentation-verified | [OCI-NOSQL-E18] |
|
|
15
|
+
| Node.js / TypeScript | `oracle-nosqldb` | Node.js 24.0.0+; TypeScript 5.0.x+ | `NoSQLClient` | documentation-verified | [OCI-NOSQL-E19] |
|
|
16
|
+
| Go | `github.com/oracle/nosql-go-sdk/nosqldb` | Go 1.24+ | `nosqldb.NewClient(cfg)` + `iam.NewSignatureProviderFromFile` | documentation-verified | [OCI-NOSQL-E32] |
|
|
17
|
+
| .NET / C# | NuGet `Oracle.NoSQL.SDK` | .NET 10.0+ | `NoSQLClient` + `IAMAuthorizationProvider` | documentation-verified | [OCI-NOSQL-E33] |
|
|
18
|
+
| Spring Data, Rust | official repos exist | not verified | not verified | unverified | [OCI-NOSQL-E16] [OCI-NOSQL-E21] |
|
|
19
|
+
|
|
20
|
+
Version pins: the Java README shows a version number inside its Maven
|
|
21
|
+
snippet. That is an example, not a statement of the latest release. Resolve the
|
|
22
|
+
current version from the package registry at implementation time; never copy a
|
|
23
|
+
pinned version from this file.
|
|
24
|
+
|
|
25
|
+
## Rules for generated code
|
|
26
|
+
|
|
27
|
+
1. **Authentication.** Use `SignatureProvider` with the user's OCI config
|
|
28
|
+
profile, or an instance/resource principal where the runtime supports it.
|
|
29
|
+
Never embed keys, fingerprints, tenancy OCIDs or passphrases in code.
|
|
30
|
+
Instance/resource-principal class names were not verified in this pass, so
|
|
31
|
+
look them up in the SDK API reference before writing them. *(rule)*
|
|
32
|
+
2. **Consistency.** Default to EVENTUAL and opt specific reads into ABSOLUTE
|
|
33
|
+
(2x read units) [OCI-NOSQL-E03].
|
|
34
|
+
3. **Table creation in code.** `TableRequest` with DDL and `TableLimits` is
|
|
35
|
+
the documented Java shape [OCI-NOSQL-E20]. Table DDL in application
|
|
36
|
+
start-up paths is a production-mutation risk: keep it in deployment
|
|
37
|
+
tooling behind approval. *(recommendation)*
|
|
38
|
+
4. **Unverified SDKs.** For Spring Data or Rust, say the details are
|
|
39
|
+
unverified [OCI-NOSQL-E21]. Fetch that SDK's README before
|
|
40
|
+
writing any code. Do not translate Java method names into another language.
|
|
41
|
+
5. **Throttling and retries.** Retry behavior and the exception class names
|
|
42
|
+
for limit-exceeded errors were not verified in this pass. Look them up in the
|
|
43
|
+
SDK API reference; do not invent exception names.
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 1.0.0 — 2026-11-08
|
|
4
|
+
|
|
5
|
+
Initial Oracle NoSQL Cloud package: lazy command/feature selector; provider-native
|
|
6
|
+
model/security/runtime; customer export/import recovery; DDL/Terraform/CLI;
|
|
7
|
+
portable adapter examples; offline guards and June/December read-only reminder.
|
|
8
|
+
No cloud execution, scheduling, host registration or SDK compilation implied.
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
# oci-nosql-pattern
|
|
2
|
+
|
|
3
|
+
Provider-correct Oracle NoSQL Database Cloud Service guidance, version **1.0.0**.
|
|
4
|
+
Start at [SKILL.md](SKILL.md). This is not Oracle AI Database/Autonomous SQL.
|
|
5
|
+
No installation, registration, live operation, background job or measured savings
|
|
6
|
+
is implied. Templates and local fake tests are not service/runtime acceptance.
|
|
7
|
+
|
|
8
|
+
## Triggers
|
|
9
|
+
|
|
10
|
+
Host-dependent agent requests; from this folder the real offline selector accepts
|
|
11
|
+
the same normal/slash-prefixed syntax and returns JSON `read` paths only.
|
|
12
|
+
|
|
13
|
+
| Intent | Trigger | Output / boundary |
|
|
14
|
+
|---|---|---|
|
|
15
|
+
| Help | `/oci-nosql-pattern help` | Commands/features only, then stop |
|
|
16
|
+
| Choose domains | `/oci-nosql-pattern select --features iam,encryption` | Selected guides, no OCI activation |
|
|
17
|
+
| Model access | `/oci-nosql-pattern design --features core,indexes,ttl` | Access matrix, shard choice, SQL/index alternatives, requested code/IaC |
|
|
18
|
+
| Change code/schema | `/oci-nosql-pattern refactor --features core,indexes` | Small compatible diff; backfill/cutover/rollback plan if needed |
|
|
19
|
+
| Offline audit | `/oci-nosql-pattern audit --mode offline --features iam,encryption,backup` | Sanitized/local evidence, no OCI inspection |
|
|
20
|
+
| Metadata audit | `/oci-nosql-pattern audit --mode live --features ttl,monitoring` | Authorized exact-target metadata only, no row scans/remediation |
|
|
21
|
+
| Performance plan | `/oci-nosql-pattern performance-test --environment nonproduction --duration-seconds 30 --max-requests 500 --max-concurrency 2` | Positive caps and further rate/cost/stop requirements; no run |
|
|
22
|
+
| Configure lifecycle | `/oci-nosql-pattern feature-plan --features ttl --action configure` | Proposed TTL change, not deployment |
|
|
23
|
+
| Security plan | `/oci-nosql-pattern feature-plan --features encryption,iam --action configure` | Managed/dedicated CMEK and rights prerequisites |
|
|
24
|
+
| Export plan | `/oci-nosql-pattern backup --method migrator --features backup,encryption` | Customer-managed JSON/Object Storage export, no snapshot/PITR promise |
|
|
25
|
+
| SDK export plan | `/oci-nosql-pattern backup --method sdk` | App-owned bounded page exporter contract, not a supplied backup service |
|
|
26
|
+
| Import plan | `/oci-nosql-pattern restore --method migrator` | Exact export/NEW table/schema/TTL approval and validation |
|
|
27
|
+
| SDK import plan | `/oci-nosql-pattern restore --method sdk` | App-owned conditional importer contract, no source overwrite |
|
|
28
|
+
| AI boundary | `/oci-nosql-pattern select --features vectors,embeddings,iam` | Numeric arrays/source provenance and external retrieval architecture |
|
|
29
|
+
|
|
30
|
+
Default features: `core`; backup/restore: `backup`. Default audit: offline; default
|
|
31
|
+
method: migrator. `--method pitr`, unknown features, empty bundles, unsafe action
|
|
32
|
+
combinations and nonpositive performance limits fail. Native ANN/vector enablement
|
|
33
|
+
is unsupported by this package: no verified NDCS native API in the reviewed docs.
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
python3 scripts/select_mode.py /oci-nosql-pattern audit --features iam,encryption
|
|
37
|
+
python3 scripts/review_due.py --as-of 2026-11-08 # replace with actual client date
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## Feature combinations
|
|
41
|
+
|
|
42
|
+
Only named paths load; indirect `embeddings`/`backup` routes do not load sibling
|
|
43
|
+
methods or live audit instructions. Unselected scope is not implicitly healthy.
|
|
44
|
+
|
|
45
|
+
| Bundle | Features | Tradeoff |
|
|
46
|
+
|---|---|---|
|
|
47
|
+
| Query/correctness | `core,indexes,ttl` | Shard locality, continuation, row expiration |
|
|
48
|
+
| Security | `iam,encryption` | Compartment/table access and dedicated CMEK prerequisites |
|
|
49
|
+
| Capacity | `core,indexes,monitoring` | Hot shards, consumed RU/WU and throttles |
|
|
50
|
+
| Recovery | `backup,ttl,encryption` | Export integrity, original expiry and key retention |
|
|
51
|
+
| Regional | `replicas,monitoring` | Replication lag/conflicts, not historical recovery |
|
|
52
|
+
| Semantic retrieval | `vectors,embeddings,iam` | App generation plus separately approved vector service |
|
|
53
|
+
|
|
54
|
+
## Manual workflow combinations
|
|
55
|
+
|
|
56
|
+
One command at a time, not `combo` or an automatic pipeline. Every transition
|
|
57
|
+
retains its own authorization; selecting a plan does not apply it.
|
|
58
|
+
|
|
59
|
+
| Goal | Manual sequence | Gate |
|
|
60
|
+
|---|---|---|
|
|
61
|
+
| New model | design → offline audit | Review actual DDL/code; approve deploy separately |
|
|
62
|
+
| Safe refactor | offline audit → refactor → performance-test | Data compatibility, rollback and separately bounded approved test |
|
|
63
|
+
| Recovery drill | backup migrator → restore migrator → live audit | Export evidence/NEW target approval; application validation before cutover |
|
|
64
|
+
| CMEK review | offline audit → feature-plan configure → live audit | Dedicated environment/service-owner plan; no fake table `kms_key_id` |
|
|
65
|
+
| Retrieval | select vectors/embeddings → design → performance-test | Separate vector store IAM/model/dimension/tenant and recall ground truth |
|
|
66
|
+
|
|
67
|
+
## Included artifacts and verification
|
|
68
|
+
|
|
69
|
+
[Provisioning](references/provisioning.md) selects matching [DDL](assets/orders.ddl),
|
|
70
|
+
[Terraform](assets/orders.tf) and guarded [OCI CLI](assets/create-table.sh). Either
|
|
71
|
+
IaC or CLI owns a NEW table, never both. Customer recovery uses reviewed Migrator
|
|
72
|
+
JSON templates and an intentionally incomplete manifest that fails the offline
|
|
73
|
+
[safety checker](scripts/check_recovery.py). No export/import is executed here.
|
|
74
|
+
[Adapters](references/language-adapters.md) cover JS/TS, Java, Rust, Kotlin via
|
|
75
|
+
Java, PHP/other REST integration plus Python/Go/.NET. Only the dependency-free
|
|
76
|
+
injected JS runtime helper is executed by local tests; SDK snippets are uncompiled.
|
|
77
|
+
|
|
78
|
+
Review every June and December; next **2026-12-01**. [Maintenance](references/maintenance.md)
|
|
79
|
+
is read-only on load, overdue stays overdue, and partial edits are not full audits.
|
|
80
|
+
See [sources/evidence](references/sources.md), [evals](evals/eval.md) and
|
|
81
|
+
[adversarial prompts](evals/prompts.json). No all-language/runtime-proof claim.
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: oci-nosql-pattern
|
|
3
|
+
description: "Design, implement, refactor and audit Oracle NoSQL Database Cloud Service access patterns in any language. Use for shard/primary keys, SQL/secondary indexes, continuation, same-shard transactions, consistency/version/TTL, OCI IAM/encryption, replicas, metrics, Terraform/DDL/OCI CLI, embeddings boundaries, bounded performance plans and customer-owned export/import recovery. Lazy command/feature routes; not Oracle SQL Database, native vector/PITR enablement or permission for live access."
|
|
4
|
+
allowed-tools: Read Grep Glob Bash(python3 scripts/select_mode.py:*) Bash(python3 scripts/review_due.py:*)
|
|
5
|
+
metadata:
|
|
6
|
+
author: "github: VincentChuWaiChow"
|
|
7
|
+
version: "1.0.0"
|
|
8
|
+
updated: "2026-11-09"
|
|
9
|
+
category: data
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# OCI NoSQL Pattern
|
|
13
|
+
|
|
14
|
+
| Always-on rule | Required behavior |
|
|
15
|
+
|---|---|
|
|
16
|
+
| Scope | Oracle NoSQL Database Cloud Service (NDCS), not Oracle Database/Autonomous SQL, on-prem snapshots or DynamoDB |
|
|
17
|
+
| Safety | No cloud, credentials, installs, data reads/writes, export/import or load on skill load; preserve current IaC owner/data |
|
|
18
|
+
| Authorization | Before live metadata reads confirm principal, tenancy, region, compartment, table and permitted evidence; writes/load/recovery need exact separate approval |
|
|
19
|
+
| Evidence | Separate request, proposed plan, local checks, control-plane readback and application proof; label facts, assumptions and UNVERIFIED |
|
|
20
|
+
| Loading | Read only selected command/features and selected audit/recovery method; do not recursively read links or sibling guides |
|
|
21
|
+
| Language | Use existing SDK/language; no forced ORM or native capability invented to match another provider |
|
|
22
|
+
|
|
23
|
+
Recognize `/oci-nosql-pattern <command>` only when the host supports skill discovery;
|
|
24
|
+
`$oci-nosql-pattern` or plain language may also select it. No host registration.
|
|
25
|
+
The real local selector emits paths, not execution:
|
|
26
|
+
`python3 scripts/select_mode.py /oci-nosql-pattern <command> [options]`.
|
|
27
|
+
|
|
28
|
+
| Command | Load only selected route |
|
|
29
|
+
|---|---|
|
|
30
|
+
| help | [Help](references/commands/help.md); show commands and stop |
|
|
31
|
+
| select | [Feature selection](references/commands/select.md) |
|
|
32
|
+
| design | [Access-pattern design](references/commands/design.md) |
|
|
33
|
+
| refactor | [Compatibility and migration](references/commands/refactor.md) |
|
|
34
|
+
| audit | [Audit](references/commands/audit.md), then selected offline/live variant |
|
|
35
|
+
| performance-test | [Bounded plan](references/commands/performance-test.md), not a run |
|
|
36
|
+
| feature-plan | [Lifecycle plan](references/commands/feature-plan.md), not application |
|
|
37
|
+
| backup | [Backup](references/commands/backup.md), then selected migrator/sdk method |
|
|
38
|
+
| restore | [Restore](references/commands/restore.md), then selected migrator/sdk method; NEW target only |
|
|
39
|
+
|
|
40
|
+
| Task/feature | Read only when selected |
|
|
41
|
+
|---|---|
|
|
42
|
+
| core | [Model](references/modeling.md) and [runtime](references/runtime-contract.md) |
|
|
43
|
+
| indexes | [Secondary indexes](references/indexes.md); no LSI/GSI classification |
|
|
44
|
+
| iam | [OCI access](references/access.md) |
|
|
45
|
+
| encryption | [Managed versus dedicated CMEK](references/encryption.md) |
|
|
46
|
+
| ttl | [Expiration](references/ttl.md) |
|
|
47
|
+
| replicas | [Global Active Tables](references/replicas.md), not backup |
|
|
48
|
+
| monitoring | [Metrics](references/monitoring.md) |
|
|
49
|
+
| vectors | [Types/native capability boundary](references/types-and-vectors.md) |
|
|
50
|
+
| embeddings | [Generation/source/retrieval integration](references/embedding-integrations.md) |
|
|
51
|
+
| backup | [Customer recovery boundary](references/recovery-boundary.md), not every method |
|
|
52
|
+
| Provisioning requested | [Terraform/DDL/CLI](references/provisioning.md), then selected asset |
|
|
53
|
+
| Language requested | [Adapters](references/language-adapters.md), matching section only |
|
|
54
|
+
| Current capability/source question | [Dated sources](references/sources.md) |
|
|
55
|
+
| Due review or skill edits | [Maintenance](references/maintenance.md) or [eval contract](evals/eval.md) |
|
|
56
|
+
|
|
57
|
+
Audit defaults offline; recovery defaults migrator. Unknown/unsupported options fail
|
|
58
|
+
closed. `vectors` is informational; native ANN activation and `--method pitr` fail.
|
|
59
|
+
Bundles/manual sequences select scope only, never persistent activation or a chain.
|
|
60
|
+
At substantive use run `scripts/review_due.py --as-of YYYY-MM-DD` with the actual
|
|
61
|
+
client-local date. Review every June/December; next **2026-12-01**. Due/overdue:
|
|
62
|
+
load Maintenance and remind the user; never roll forward or schedule notifications.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Illustrative billable NEW-table operation. Never invoked on skill load.
|
|
3
|
+
set -euo pipefail
|
|
4
|
+
: "${OCI_PROFILE:?approved existing profile}"
|
|
5
|
+
: "${OCI_REGION:?approved region}"
|
|
6
|
+
: "${TENANCY_OCID:?approved tenancy OCID}"
|
|
7
|
+
: "${COMPARTMENT_OCID:?approved compartment OCID}"
|
|
8
|
+
: "${PRINCIPAL_OCID:?externally verified approved principal OCID}"
|
|
9
|
+
: "${TABLE_NAME:?approved NEW table name}"
|
|
10
|
+
[[ "$TABLE_NAME" =~ ^[A-Za-z][A-Za-z0-9_]{0,63}$ ]] || { echo "Unsafe name" >&2; exit 1; }
|
|
11
|
+
asset_dir=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)
|
|
12
|
+
oci_cmd=(oci --profile "$OCI_PROFILE" --region "$OCI_REGION")
|
|
13
|
+
# These metadata reads confirm reachable targets, NOT the current principal identity.
|
|
14
|
+
observed_tenancy=$("${oci_cmd[@]}" iam tenancy get --tenancy-id "$TENANCY_OCID" --query data.id --raw-output)
|
|
15
|
+
[[ "$observed_tenancy" == "$TENANCY_OCID" ]] || { echo "Tenancy mismatch" >&2; exit 1; }
|
|
16
|
+
observed_compartment=$("${oci_cmd[@]}" iam compartment get --compartment-id "$COMPARTMENT_OCID" --query data.id --raw-output)
|
|
17
|
+
[[ "$observed_compartment" == "$COMPARTMENT_OCID" ]] || { echo "Compartment mismatch" >&2; exit 1; }
|
|
18
|
+
printf 'Declared principal=%s tenancy=%s compartment=%s region=%s NEW table=%s\n' "$PRINCIPAL_OCID" "$TENANCY_OCID" "$COMPARTMENT_OCID" "$OCI_REGION" "$TABLE_NAME"
|
|
19
|
+
read -r -p "After independent principal verification, type CREATE ${TABLE_NAME}: " confirmation
|
|
20
|
+
[[ "$confirmation" == "CREATE ${TABLE_NAME}" ]] || exit 1
|
|
21
|
+
ddl=$(cat "$asset_dir/orders.ddl")
|
|
22
|
+
ddl=${ddl/CREATE TABLE orders_v1/CREATE TABLE ${TABLE_NAME}}
|
|
23
|
+
# No IF NOT EXISTS, adoption, cleanup or deletion. A conflict is a hard stop.
|
|
24
|
+
"${oci_cmd[@]}" nosql table create --compartment-id "$COMPARTMENT_OCID" --name "$TABLE_NAME" \
|
|
25
|
+
--ddl-statement "$ddl" --table-limits "file://${asset_dir}/table-limits.json" \
|
|
26
|
+
--is-auto-reclaimable false --freeform-tags '{"purpose":"orders-example"}' --wait-for-state SUCCEEDED --max-wait-seconds 1200
|
|
27
|
+
"${oci_cmd[@]}" nosql index create --compartment-id "$COMPARTMENT_OCID" --table-name-or-id "$TABLE_NAME" \
|
|
28
|
+
--index-name tenant_status_created --keys "file://${asset_dir}/index-keys.json" \
|
|
29
|
+
--is-if-not-exists false --wait-for-state SUCCEEDED --max-wait-seconds 1200
|
|
30
|
+
# Readback is not application acceptance, ownership or backup proof.
|
|
31
|
+
"${oci_cmd[@]}" nosql table get --compartment-id "$COMPARTMENT_OCID" --table-name-or-id "$TABLE_NAME"
|
|
32
|
+
"${oci_cmd[@]}" nosql index get --compartment-id "$COMPARTMENT_OCID" --table-name-or-id "$TABLE_NAME" --index-name tenant_status_created
|