@raishin/vanguard-frontier-agentic 3.18.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 +620 -75
- package/catalog/install-roles.json +19 -1
- package/catalog/model-assignments.json +231 -0
- package/catalog/skill-manifest.json +2074 -527
- package/catalog/skills.json +314 -14
- package/package.json +8 -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/rules/codex/cloud-provenance-rule.md +1 -1
- package/scripts/generate-kiro-powers.mjs +2 -2
- 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-ai-foundry-ops-governor/SKILL.md +2 -2
- package/skills/azure/azure-aks-platform-operator/SKILL.md +1 -1
- package/skills/azure/azure-app-service-production-readiness/SKILL.md +1 -1
- package/skills/azure/azure-cosmosdb-application-developer/SKILL.md +5 -3
- 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-performance-investigator/SKILL.md +1 -1
- package/skills/azure/azure-cosmosdb-platform-operator/SKILL.md +7 -3
- 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-cost-estimation-review/SKILL.md +1 -1
- package/skills/azure/azure-cost-optimization-governor/SKILL.md +1 -1
- package/skills/azure/azure-entra-id-specialist/SKILL.md +1 -1
- package/skills/azure/azure-governance-policy-guardrails/SKILL.md +1 -1
- package/skills/azure/azure-identity-governance-review/SKILL.md +1 -1
- package/skills/azure/azure-key-vault-secret-lifecycle-auditor/SKILL.md +1 -1
- package/skills/azure/azure-landing-zone-architect/SKILL.md +1 -1
- package/skills/azure/azure-maestro/SKILL.md +2 -1
- package/skills/azure/azure-migrate-landing-zone-cutover/SKILL.md +1 -1
- package/skills/azure/azure-network-topology-review/SKILL.md +1 -1
- package/skills/azure/azure-observability-investigator/SKILL.md +1 -1
- package/skills/azure/azure-platform-automation-devops/SKILL.md +1 -1
- package/skills/azure/azure-private-endpoint-adoption-planner/SKILL.md +1 -1
- package/skills/azure/azure-rbac-review/SKILL.md +1 -1
- package/skills/azure/azure-resilience-bcdr-review/SKILL.md +1 -1
- package/skills/azure/azure-resource-health-incident-triage/SKILL.md +1 -1
- package/skills/azure/azure-role-selector/SKILL.md +1 -1
- package/skills/azure/azure-security-posture-hardening/SKILL.md +1 -1
- package/skills/azure/azure-subscription-resource-organization/SKILL.md +1 -1
- package/skills/azure/azure-waf-cost-optimization-review/SKILL.md +1 -1
- package/skills/azure/azure-waf-reliability-review/SKILL.md +1 -1
- package/skills/azure/azure-waf-security-review/SKILL.md +1 -1
- package/skills/contabo/contabo-security-hardening/SKILL.md +1 -1
- package/skills/cross-functional/agentic-board-protocol/SKILL.md +1 -1
- package/skills/cross-functional/copilot-data-readiness-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-case-capsule/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-data-exposure-escalation-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-live-change-approval-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-risk-taxonomy/SKILL.md +1 -1
- package/skills/databricks/databricks-lakehouse-engineering-at-azure/SKILL.md +1 -1
- package/skills/databricks/databricks-unity-catalog-governance-at-azure/SKILL.md +1 -1
- package/skills/dotnet/dotnet-performance-aot-review/SKILL.md +1 -1
- package/skills/frontend/vue-router-navigation-security-review/SKILL.md +1 -1
- 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/java/java-application-server-exit/SKILL.md +1 -1
- package/skills/java/java-jvm-performance-and-gc/SKILL.md +1 -1
- package/skills/java/java-resilience-pattern/SKILL.md +1 -1
- package/skills/java/java-test-architecture/SKILL.md +1 -1
- package/skills/java/java-transaction-and-consistency/SKILL.md +1 -1
- package/skills/kubernetes/kubernetes-rbac-review/SKILL.md +1 -1
- package/skills/marketing/analytics-data-minimization-review/SKILL.md +1 -1
- package/skills/microsoft/d365-customer-insights-journeys/SKILL.md +1 -1
- package/skills/microsoft/fabric-analytics-engineering/SKILL.md +1 -1
- package/skills/microsoft/m365-defender-xdr-security-operations/SKILL.md +1 -1
- package/skills/microsoft/m365-purview-data-security-compliance/SKILL.md +1 -1
- package/skills/oci/README.md +6 -1
- package/skills/oci/oci-autonomous-database-architect/SKILL.md +1 -1
- package/skills/oci/oci-certificates-issuer-review/SKILL.md +1 -1
- package/skills/oci/oci-cloud-guard-responder/SKILL.md +1 -1
- package/skills/oci/oci-compute-instance-agent-operator/SKILL.md +1 -1
- package/skills/oci/oci-compute-platform-operator/SKILL.md +1 -1
- package/skills/oci/oci-cost-finops-analyst/SKILL.md +1 -1
- package/skills/oci/oci-database-platform-dba/SKILL.md +1 -1
- package/skills/oci/oci-dbtools-sql-analyst/SKILL.md +1 -1
- package/skills/oci/oci-devops-container-platform-engineer/SKILL.md +1 -1
- package/skills/oci/oci-exadata-database-architect/SKILL.md +1 -1
- package/skills/oci/oci-exadata-platform-architect/SKILL.md +1 -1
- package/skills/oci/oci-fusion-apps-environment-operator/SKILL.md +1 -1
- package/skills/oci/oci-goldengate-replication-operator/SKILL.md +1 -1
- package/skills/oci/oci-identity-access-governor/SKILL.md +1 -1
- package/skills/oci/oci-iot-digital-twin-engineer/SKILL.md +1 -1
- package/skills/oci/oci-limits-capacity-planner/SKILL.md +1 -1
- package/skills/oci/oci-live-autonomous-db-lifecycle-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-cost-budget-runaway-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-iam-policy-compartment-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-network-security-rule-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-oke-rollout-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-resource-manager-stack-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-vault-key-destruction-guard/SKILL.md +1 -1
- package/skills/oci/oci-load-balancer-traffic-engineer/SKILL.md +1 -1
- package/skills/oci/oci-maestro/SKILL.md +1 -1
- package/skills/oci/oci-migration-cutover-architect/SKILL.md +1 -1
- package/skills/oci/oci-multi-cloud-architect/SKILL.md +1 -1
- package/skills/oci/oci-mysql-heatwave-ai-specialist/SKILL.md +1 -1
- package/skills/oci/oci-network-architect/SKILL.md +1 -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/oci/oci-observability-incident-responder/SKILL.md +1 -1
- package/skills/oci/oci-recovery-service-operator/SKILL.md +1 -1
- package/skills/oci/oci-registry-artifact-governor/SKILL.md +1 -1
- package/skills/oci/oci-resource-search-inventory-analyst/SKILL.md +1 -1
- package/skills/oci/oci-security-compliance-reviewer/SKILL.md +1 -1
- package/skills/oci/oci-solution-architect/SKILL.md +1 -1
- package/skills/oci/oci-storage-backup-steward/SKILL.md +1 -1
- package/skills/oci/oci-support-incident-coordinator/SKILL.md +1 -1
- package/skills/oci/oci-waf-cost-optimization-review/SKILL.md +1 -1
- package/skills/oci/oci-waf-reliability-review/SKILL.md +1 -1
- package/skills/oci/oci-waf-security-review/SKILL.md +1 -1
- package/skills/oci/oracle-oci-mcp-grounded-advisor/SKILL.md +1 -1
- package/skills/ovhcloud/ovhcloud-cost-finops-analyst/SKILL.md +1 -1
- package/skills/ovhcloud/ovhcloud-live-kms-key-destruction-guard/SKILL.md +1 -1
- 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/salesforce/salesforce-agentforce-risk-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-apex-lwc-code-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-devsecops-pipeline-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-flow-automation-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-infrastructure-audit-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-integration-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-marketing-consent-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-metadata-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-org-assessment-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-permission-model-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-release-readiness-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-zero-trust-maturity-skill/SKILL.md +1 -1
- package/skills/sap/sap-analytics-cloud-planning-governance/SKILL.md +1 -1
- package/skills/sap/sap-btp-governance-review/SKILL.md +1 -1
- package/skills/sap/sap-cloud-alm-sre-incident-review/SKILL.md +1 -1
- package/skills/sap/sap-datasphere-data-product-architecture/SKILL.md +1 -1
- package/skills/sap/sap-ewm-tm-logistics-execution-review/SKILL.md +1 -1
- package/skills/sap/sap-finance-fico-controls-review/SKILL.md +1 -1
- package/skills/sap/sap-hana-cloud-performance-cost/SKILL.md +1 -1
- package/skills/sap/sap-hypercare-incident-commander-review/SKILL.md +1 -1
- package/skills/sap/sap-integration-suite-review/SKILL.md +1 -1
- package/skills/sap/sap-joule-governance-adoption-review/SKILL.md +1 -1
- package/skills/sap/sap-license-btp-consumption-finops-review/SKILL.md +1 -1
- package/skills/sap/sap-manufacturing-execution-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-mdg-master-data-quality-review/SKILL.md +1 -1
- package/skills/sap/sap-order-to-cash-review/SKILL.md +1 -1
- package/skills/sap/sap-procurement-ariba-value-leakage-review/SKILL.md +1 -1
- package/skills/sap/sap-release-change-collision-review/SKILL.md +1 -1
- package/skills/sap/sap-rise-sla-vendor-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-security-iam-grc-sod-review/SKILL.md +1 -1
- package/skills/sap/sap-signavio-process-mining-value/SKILL.md +1 -1
- package/skills/sap/sap-successfactors-hr-process-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-supply-chain-ibp-resilience-review/SKILL.md +1 -1
- package/skills/sap/sap-testing-quality-gate-review/SKILL.md +1 -1
- package/skills/sap/sap-transformation-portfolio-triage-review/SKILL.md +1 -1
- package/skills/sap/sap-treasury-cash-risk-review/SKILL.md +1 -1
- package/skills/scaleway/scaleway-kapsule-platform-operator/SKILL.md +1 -1
- 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/skills/scaleway/scaleway-network-architect/SKILL.md +1 -1
- 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/test-marketplace-validators.py +7 -1
- package/tests/validate-agent-frontmatter-schema.py +7 -1
- package/tests/validate-aws-skill-quality.py +7 -0
- package/tests/validate-kiro-powers.py +8 -1
- 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-frontmatter-schema.py +7 -1
- package/tests/validate-skill-manifest.py +6 -1
- package/tests/validate-skill-references.py +225 -0
- package/tests/validate-skill-yaml-strict.py +84 -0
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# Evidence ledger — Oracle NoSQL Database Cloud Service
|
|
2
|
+
|
|
3
|
+
Every material claim in this skill cites one row below as `[OCI-NOSQL-Exx]`.
|
|
4
|
+
`tests/validate-skill-references.py` fails the build if a citation has no row,
|
|
5
|
+
a row is never cited, or a source is not on an allow-listed Oracle host.
|
|
6
|
+
|
|
7
|
+
Scope: **Oracle NoSQL Database Cloud Service (NDCS)** on OCI, "Latest Cloud
|
|
8
|
+
Release" documentation, non-hosted (standard) environment unless a row says
|
|
9
|
+
otherwise. Not Oracle Autonomous Database, not Oracle Database JSON, not
|
|
10
|
+
on-premises Oracle NoSQL Database.
|
|
11
|
+
|
|
12
|
+
Status meaning: `VERIFIED` = the quoted section was retrieved from the source
|
|
13
|
+
on the retrieval date and supports the claim as worded. `UNVERIFIED` = recorded
|
|
14
|
+
gap; do not present it as fact. `CONFLICT` = the source contradicts itself; do
|
|
15
|
+
not rely on either value. Documentation verification is not a behavioral test
|
|
16
|
+
against a live tenancy. Limits and prices are volatile: re-fetch before relying
|
|
17
|
+
on a number.
|
|
18
|
+
|
|
19
|
+
| ID | Claim | Source | Section | Retrieved | Status |
|
|
20
|
+
| --- | --- | --- | --- | --- | --- |
|
|
21
|
+
| OCI-NOSQL-E01 | A table is created with Provisioned Capacity (fixed read/write throughput and storage limits) or On-Demand Capacity (Oracle manages read/write capacity; storage still limited). | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/cloud-concepts.html> | Capacity | 2026-11-08 | VERIFIED |
|
|
22
|
+
| OCI-NOSQL-E02 | Table data is automatically sharded on the shard key, a portion of the primary key. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/cloud-concepts.html> | Distribution and Sharding | 2026-11-08 | VERIFIED |
|
|
23
|
+
| OCI-NOSQL-E03 | Read consistency is EVENTUAL or ABSOLUTE; ABSOLUTE consumes twice the read units of EVENTUAL; it can be set on the NoSQL handle or per read operation. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/cloud-concepts.html> | Read Consistency | 2026-11-08 | VERIFIED |
|
|
24
|
+
| OCI-NOSQL-E04 | Primary keys and shard keys are created only at table creation and cannot be changed or dropped for the life of the table. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/designing-a-table-in-oracle-nosql-database-cloud-service.html> | Primary Keys and Shard Keys | 2026-11-08 | VERIFIED |
|
|
25
|
+
| OCI-NOSQL-E05 | Shard-key guidance: high cardinality (low cardinality causes hot shards) and atomicity (only records sharing a shard key can join one transaction) are named factors; uniform distribution and query isolation (queries not targeted to one shard run on all shards) are listed with them. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/designing-a-table-in-oracle-nosql-database-cloud-service.html> | Important factors to consider when choosing a shard key | 2026-11-08 | VERIFIED |
|
|
26
|
+
| OCI-NOSQL-E06 | If no shard key is designated, the primary key is used for shard organization. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/designing-a-table-in-oracle-nosql-database-cloud-service.html> | Shard Keys | 2026-11-08 | VERIFIED |
|
|
27
|
+
| OCI-NOSQL-E07 | Table TTL defaults to zero (no expiry), is declared in HOURS or DAYS, rows inherit it unless a row TTL overrides it, expired rows can no longer be retrieved, and expired data is purged from disk after expiration. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/designing-a-table-in-oracle-nosql-database-cloud-service.html> | Time to Live | 2026-11-08 | VERIFIED |
|
|
28
|
+
| OCI-NOSQL-E08 | Child tables inherit the parent primary key and share the root table shard key; a parent cannot be dropped before its children; referential integrity is not enforced; writes across the hierarchy get ACID semantics. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/designing-a-table-in-oracle-nosql-database-cloud-service.html> | Table Hierarchies | 2026-11-08 | VERIFIED |
|
|
29
|
+
| OCI-NOSQL-E09 | Global Active tables replicate active-active across regions asynchronously; concurrent conflicts resolve by the built-in rule that the update with the latest timestamp wins. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/global-active-tables-in-ndcs.html> | Global Active Tables in NDCS | 2026-11-08 | VERIFIED |
|
|
30
|
+
| OCI-NOSQL-E10 | For Global Active tables, ACID transactions and ABSOLUTE consistency are local to one region; reads of data replicated from another region are always eventually consistent. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/global-active-tables-in-ndcs.html> | Global Active Tables in NDCS | 2026-11-08 | VERIFIED |
|
|
31
|
+
| OCI-NOSQL-E11 | Adding a replica requires that no same-name table exists in the receiver region and that a same-name compartment already exists there; in most cases identity columns should not be used because they are not guaranteed unique across replicas; storage limit is copied to all replicas; read and write limits and capacity mode can differ per replica; the creator must grant table read/write permissions per replica. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/global-active-tables-in-ndcs.html> | Global Active Tables in NDCS | 2026-11-08 | VERIFIED |
|
|
32
|
+
| OCI-NOSQL-E12 | A table must have a frozen schema before it becomes a Global Active table: `with schema frozen` when it has JSON columns, `with schema frozen force` when it has none. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/using-apis-to-create-a-global-active-table.html> | Using APIs to create a Global Active Table | 2026-11-08 | VERIFIED |
|
|
33
|
+
| OCI-NOSQL-E13 | IAM resource type `nosql-rows`: READ grants NOSQL_ROWS_READ (get/query SELECT); USE adds NOSQL_ROWS_INSERT (put/update); MANAGE adds NOSQL_ROWS_DELETE. Index create/drop requires MANAGE on `nosql-indexes`. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/oracle-nosql-database-cloud-service-policies-reference.html> | nosql-rows; nosql-indexes | 2026-11-08 | VERIFIED |
|
|
34
|
+
| OCI-NOSQL-E14 | Capacity mode can be switched between Provisioned and On-Demand in either direction; the service supports schema-based and schema-less (JSON) modeling; ACID transactions are supported and consistency can be relaxed for latency. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/features-of-oracle-nosql-database-cloud-service.html> | Features of Oracle NoSQL Database Cloud Service | 2026-11-08 | VERIFIED |
|
|
35
|
+
| OCI-NOSQL-E15 | One Write Unit is throughput for up to 1 KB per second and index updates also consume write units; one Read Unit is throughput for up to 1 KB per second of eventually consistent reads. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/plan-your-service.html> | Estimating Capacity | 2026-11-08 | VERIFIED |
|
|
36
|
+
| OCI-NOSQL-E16 | Official Oracle NoSQL SDK repositories exist for Java, Python, Go, Node.js, .NET, Spring Data and Rust (linked from the NDCS documentation index). | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/> | IDE and SDKs | 2026-11-08 | VERIFIED |
|
|
37
|
+
| OCI-NOSQL-E17 | Java SDK: Maven `com.oracle.nosql.sdk:nosqldriver`, Java 11 or higher. | <https://github.com/oracle/nosql-java-sdk> | Installation | 2026-11-08 | VERIFIED |
|
|
38
|
+
| OCI-NOSQL-E18 | Python SDK: `pip install borneo`, plus `pip install oci` for the cloud service; Python 3.12+; handle via `NoSQLHandle(NoSQLHandleConfig(endpoint, provider))` with `borneo.iam.SignatureProvider`. | <https://github.com/oracle/nosql-python-sdk> | README | 2026-11-08 | VERIFIED |
|
|
39
|
+
| OCI-NOSQL-E19 | Node.js SDK: `npm install oracle-nosqldb`, Node.js 24.0.0+, TypeScript 5.0.x+ when used; client class `NoSQLClient`. | <https://github.com/oracle/nosql-node-sdk> | Prerequisites; Installation | 2026-11-08 | VERIFIED |
|
|
40
|
+
| OCI-NOSQL-E20 | Java API shapes in Oracle's example: `NoSQLHandleConfig(endpoint).setAuthorizationProvider(new SignatureProvider())`, `NoSQLHandleFactory.createNoSQLHandle(config)`, `TableRequest().setStatement(ddl).setTableLimits(new TableLimits(r, w, gb))`, `AddReplicaRequest().setTableName(..).setReplicaName(region)`. The example itself does not compile as printed (for example `System.output.println`), so it supports API names only, not copyable code. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/using-apis-to-create-a-global-active-table.html> | Java example | 2026-11-08 | VERIFIED |
|
|
41
|
+
| OCI-NOSQL-E21 | Package names, minimum runtimes and auth classes for the Spring Data and Rust SDKs, and Java instance/resource-principal factory methods, were not retrieved in this pass. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/> | IDE and SDKs | 2026-11-08 | UNVERIFIED |
|
|
42
|
+
| OCI-NOSQL-E22 | An NDCS-specific private endpoint, per-region pricing and per-tenancy quota increases were not found in the NDCS documentation in this pass. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/> | Get Started index | 2026-11-08 | UNVERIFIED |
|
|
43
|
+
| OCI-NOSQL-E23 | Non-hosted capacity limits: Provisioned max 40,000 read units and 20,000 write units per table; On-Demand max 10,000 read units and 5,000 write units per table and 3 On-Demand tables per region; capacity mode can be changed only once per day; throughput/storage increases are unlimited but at most four decreases per 24-hour period; per region at most 100,000 read units and 40,000 write units. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/plan-your-service.html> | Service limits table | 2026-11-08 | VERIFIED |
|
|
44
|
+
| OCI-NOSQL-E24 | Non-hosted table limits: at most 5 indexes per table, 512 KB per row, 30 tables per region, 100 schema updates per table, 4 DDL operations per minute per region, and 5 TB total storage per tenant. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/plan-your-service.html> | Service limits table | 2026-11-08 | VERIFIED |
|
|
45
|
+
| OCI-NOSQL-E25 | Writes can consume read units: puts with Option.IfAbsent/IfPresent consume reads (absolute, x2); updates via a query statement and deletes consume both read units (absolute, x2) and write units; incoming replicated writes on Global Active table replicas are charged as writes consumed. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/plan-your-service.html> | Estimating Capacity; Global Active table costs | 2026-11-08 | VERIFIED |
|
|
46
|
+
| OCI-NOSQL-E26 | To change a Global Active table's schema after replicas exist you must drop all regional replicas, alter the schema, then re-add the replicas; Oracle therefore recommends at least one JSON column. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/global-active-tables-in-ndcs.html> | Global Active Tables in NDCS | 2026-11-08 | VERIFIED |
|
|
47
|
+
| OCI-NOSQL-E27 | A child table of a Global Active table can be a singleton or a Global Active table; to make it Global Active, freeze the child's schema and add a regional replica. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/global-active-tables-in-ndcs.html> | Global Active Tables in NDCS | 2026-11-08 | VERIFIED |
|
|
48
|
+
| OCI-NOSQL-E28 | A data change in one replica is replicated to all other replicas regardless of user permission; adding or dropping a replica needs NOSQL_TABLE_ALTER in the sender and all existing receiver regions, plus NOSQL_TABLE_CREATE (add) or NOSQL_TABLE_DROP (drop) in the receiver region. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/global-active-tables-in-ndcs.html> | Global Active Tables in NDCS | 2026-11-08 | VERIFIED |
|
|
49
|
+
| OCI-NOSQL-E29 | IAM resource type `nosql-tables`: USE adds NOSQL_TABLE_ALTER (UpdateTable: change TableLimits, ALTER TABLE); MANAGE adds NOSQL_TABLE_CREATE and NOSQL_TABLE_DROP; the policy variable `target.nosql-table.name` restricts access to a named table. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/oracle-nosql-database-cloud-service-policies-reference.html> | nosql-tables; supported variables | 2026-11-08 | VERIFIED |
|
|
50
|
+
| OCI-NOSQL-E30 | The customer is responsible for backing up and restoring tables (Oracle provides a migrator tool using Object Storage); currently a dedicated hosted environment does not support Global Active tables. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/features-of-oracle-nosql-database-cloud-service.html> | Responsibilities; hosted vs non-hosted | 2026-11-08 | VERIFIED |
|
|
51
|
+
| OCI-NOSQL-E31 | Hosted-environment throughput totals are stated inconsistently on the same page (one row: 420,000 read / 280,000 write units; another: 420,000 write / 280,000 read units). | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/plan-your-service.html> | Service limits table | 2026-11-08 | CONFLICT |
|
|
52
|
+
| OCI-NOSQL-E32 | Go SDK: import `github.com/oracle/nosql-go-sdk/nosqldb` (IAM in `.../nosqldb/auth/iam`), Go 1.24 or later; client via `nosqldb.NewClient(cfg)` with `iam.NewSignatureProviderFromFile(...)` as the `AuthorizationProvider`. | <https://github.com/oracle/nosql-go-sdk> | README | 2026-11-08 | VERIFIED |
|
|
53
|
+
| OCI-NOSQL-E33 | .NET SDK: `dotnet add package Oracle.NoSQL.SDK`, .NET 10.0 or later; operations go through `NoSQLClient`, authorized for the cloud service with `IAMAuthorizationProvider`. | <https://github.com/oracle/nosql-dotnet-sdk> | README | 2026-11-08 | VERIFIED |
|
|
54
|
+
| OCI-NOSQL-E34 | An Oracle reference architecture states that a service gateway gives a VCN access to Oracle NoSQL Database Cloud Service, with traffic over the Oracle network fabric that never traverses the internet. This is a solution page, not the NDCS reference documentation. | <https://docs.oracle.com/en/solutions/deploy-containerized-video-app-graphql-nosql/index.html> | Architecture: Service gateway | 2026-11-08 | VERIFIED |
|
|
55
|
+
| OCI-NOSQL-E35 | By default NDCS uses an Oracle-managed master encryption key. Customer-managed encryption keys (CMEK) must be enabled in a dedicated environment; the master key is held in OCI KMS vaults, must be AES (symmetric) with a 256-bit length, and only single-version keys are supported. Backups of a CMEK dedicated environment in Object Storage are also encrypted with that key. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/introduction-to-customer-managed-encryption-keys.html> | Introduction to Customer-Managed Encryption keys | 2026-11-08 | VERIFIED |
|
|
56
|
+
| OCI-NOSQL-E101 | Restore is a customer task: Oracle provides a migrator tool that can restore a table from files stored in Oracle Object Storage. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/features-of-oracle-nosql-database-cloud-service.html> | Responsibility Model for Oracle NoSQL Database: Restoring a table: "Oracle provides a migrator tool that can be used to restore a table from files stored in Oracle Object Storage." | 2026-11-08 | VERIFIED |
|
|
57
|
+
| OCI-NOSQL-E102 | Oracle's worked backup example uses NoSQL Database Migrator to copy a table to a JSON file in OCI Object Storage as a periodic backup; if the table already exists at the sink with a different schema the migration fails. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/using-oracle-nosql-database-migrator.html> | Migrate from Oracle NoSQL Database Cloud Service to OCI Object Storage: "If the table already exists at the sink with a different schema from the source table, the migration will fail." | 2026-11-08 | VERIFIED |
|
|
58
|
+
| OCI-NOSQL-E103 | Within a region, data is stored across multiple Availability Domains (ADs), or Fault Domains (FDs) in single-AD regions, so data stays accessible if one AD or FD becomes unavailable. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/features-of-oracle-nosql-database-cloud-service.html> | Features of Oracle NoSQL Database Cloud Service: Data Safety in Redundancy: "If an AD or FD becomes unavailable, user data is still accessible from another AD or FD." | 2026-11-08 | VERIFIED |
|
|
59
|
+
| OCI-NOSQL-E104 | If one region is unavailable the application requests can be redirected to a region holding a Global Active replica, and reads and writes continue there; the failed region's replica resynchronizes when it returns. Redirection is described as an application action, with no service-driven failover mode documented. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/global-active-tables-in-ndcs.html> | Global Active Tables in NDCS: Multi-Region Resiliency: "If a single region becomes unavailable or offline, the application requests can be redirected to a region where the table is replicated" | 2026-11-08 | VERIFIED |
|
|
60
|
+
| OCI-NOSQL-E105 | Replication is asynchronous: a write completes in the sender region without waiting for replica regions, so a lag exists; the page states no RPO or RTO figure. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/global-active-tables-in-ndcs.html> | Global Active Tables in NDCS: replication lag: "the write operation is executed completely in the sender region without waiting for the replica regions to update" | 2026-11-08 | VERIFIED |
|
|
61
|
+
| OCI-NOSQL-E106 | Global Active table billing has two components: the singleton-table model (read units, write units and GB storage per month) plus incoming replicated writes at each regional replica, charged on writes consumed. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/plan-your-service.html> | Cost/Billing for Global Active Tables: "The cost/billing for a Global Active table has two components." | 2026-11-08 | VERIFIED |
|
|
62
|
+
| OCI-NOSQL-E107 | A dedicated hosted environment is billed as a single monthly price for the entire environment instead of per provisioned or on-demand read, write and storage unit. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/features-of-oracle-nosql-database-cloud-service.html> | Difference between hosted and non-hosted environments: "Instead of being charged individually for provisioned or on-demand read/write/storage units, you are charged a single monthly price for the entire hosted environment." | 2026-11-08 | VERIFIED |
|
|
63
|
+
| OCI-NOSQL-E108 | The Cost Estimator takes read units, write units and storage as inputs; with autoscale an end-of-month invoice reflects actual read and write unit consumption, so Oracle suggests logging the consumed units returned with every API call to reconcile. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/plan-your-service.html> | Estimating Your Monthly Cost: "The Cost Estimator automatically calculates your monthly cost based on your input of read units, write units, and storage." | 2026-11-08 | VERIFIED |
|
|
64
|
+
| OCI-NOSQL-E110 | NDCS sends metrics to the OCI Monitoring service in namespace oci_nosql with dimensions resourceId and tableName: ReadUnits, WriteUnits, StorageGB, ReadThrottleCount, WriteThrottleCount, StorageThrottleCount, MaxShardSizeUsagePercent, and Replica Lag (extra dimension replica). | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/monitoring-oracle-nosql-database-cloud-service.html> | Service Metrics: "Oracle NoSQL Database Cloud Service sends metrics to the Oracle Cloud Infrastructure Monitoring Service." | 2026-11-08 | VERIFIED |
|
|
65
|
+
| OCI-NOSQL-E111 | Oracle recommends an alarm on MaxShardSizeUsagePercent, for example at 90 percent, delivered through the OCI Notifications service such as email. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/monitoring-oracle-nosql-database-cloud-service.html> | Monitoring the MaxShardSizeUsagePercent metric: "That is you should trigger an alarm when the metric reaches a particular value, say for example 90 percent." | 2026-11-08 | VERIFIED |
|
|
66
|
+
| OCI-NOSQL-E112 | A throttling exception usually indicates the provisioned read throughput was exceeded; if frequent, increase Read Units (the write and storage throttle counts are described the same way for Write Units and storage capacity). | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/monitoring-oracle-nosql-database-cloud-service.html> | Read throttle count: "A throttling exception usually indicates that the provisioned read throughput has been exceeded." | 2026-11-08 | VERIFIED |
|
|
67
|
+
| OCI-NOSQL-E113 | When maxShardSizeUsagePercent reaches 100 writes to the table stop until storage is increased; it can reach 100 before all allocated storage is used when data is imbalanced across shards, a hotspot signal; Oracle advises a high-cardinality shard key and few child tables. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/monitoring-oracle-nosql-database-cloud-service.html> | Max shard usage percent: "When maxShardSizeUsagepercent reaches 100, you can no longer do a write operation in the table." | 2026-11-08 | VERIFIED |
|
|
68
|
+
| OCI-NOSQL-E114 | Replica Lag is the time lag in replicating Global Active table changes from a sender region to a receiver region, measured in milliseconds and viewed in the receiver region. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/monitoring-oracle-nosql-database-cloud-service.html> | Replica lag: "A time lag in replicating the data changes of a Global Active table from a sender region to a receiver region." | 2026-11-08 | VERIFIED |
|
|
69
|
+
| OCI-NOSQL-E115 | Table actions emit OCI Events (for example com.oraclecloud.nosql.createtable.begin/end, droptable, altertable, createindex, dropindex, addreplica, dropreplica, changecompartment) that rules can route to notifications; the event payload carries freeformTags. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/fnsxl/> | Service Events: "Actions that you perform on Oracle NoSQL Database Cloud Service tables emit events." | 2026-11-08 | VERIFIED |
|
|
70
|
+
| OCI-NOSQL-E116 | Compartment quotas exist for NoSQL (hosted-environment-count, read-unit-count, write-unit-count, table-size-gb), set with statements such as set nosql quota read-unit-count to N in compartment X. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/fnsxl/> | Service Quotas: "You can set quotas using the Console or API." | 2026-11-08 | VERIFIED |
|
|
71
|
+
| OCI-NOSQL-E117 | Policy verbs are cumulative (inspect, read, use, manage) over three NoSQL resource types (nosql-tables, nosql-rows, nosql-indexes); variables target.nosql-table.id and target.nosql-table.name scope a statement to one table. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/oracle-nosql-database-cloud-service-policies-reference.html> | Details for Verb + Resource-Type Combinations: "Use this variable to control access to specific NoSQL table by name." | 2026-11-08 | VERIFIED |
|
|
72
|
+
| OCI-NOSQL-E118 | Resource-principal or instance-principal callers require a tenancy administrator to create policies, dynamic groups and rules before the call. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/about-setting-up-users-groups-and-policies.html> | Setting up Dynamic Group and Policies: "Prior to making a call to an Oracle Cloud Infrastructure resource using either resource principals or instance principals" | 2026-11-08 | VERIFIED |
|
|
73
|
+
| OCI-NOSQL-E119 | OCI tags can be attached to a Global Active table; tags are not replicated, so replicas in different regions can carry different tags. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/global-active-tables-in-ndcs.html> | Global Active Tables in NDCS: "OCI tags are not replicated, and a Global Active Table can have different tags in different regions." | 2026-11-08 | VERIFIED |
|
|
74
|
+
| OCI-NOSQL-E120 | Data is encrypted at rest with AES 256 and in motion with HTTPS. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/features-of-oracle-nosql-database-cloud-service.html> | Features of Oracle NoSQL Database Cloud Service: Data Security: "Data is encrypted at rest (on disk) with Advanced Encryption Standard (AES 256)." | 2026-11-08 | VERIFIED |
|
|
75
|
+
| OCI-NOSQL-E121 | Oracle states it ensures stored table data is encrypted and that connections require TLS 1.2 encryption and wallet-based authentication; the customer owns user access, network access and data access. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/features-of-oracle-nosql-database-cloud-service.html> | Responsibility Model: Application security: "Oracle ensures that data stored in NoSQL Database tables is encrypted and ensures that connections to NoSQL Database tables require TLS 1.2 encryption and wallet-based authentication." | 2026-11-08 | VERIFIED |
|
|
76
|
+
| OCI-NOSQL-E122 | In a CMEK dedicated environment NDCS uses OCI Audit to log all key state changes (timestamp, previous and new CMEK state, impacted endpoint) and the OCI Monitoring metric EncryptionKeyStatus supports alarms. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/introduction-to-customer-managed-encryption-keys.html> | OCI Audit Logs: "Oracle NoSQL Database Cloud Service uses OCI Audit services to log all key state changes." | 2026-11-08 | VERIFIED |
|
|
77
|
+
| OCI-NOSQL-E123 | A service gateway lets a VCN privately reach specific Oracle services without an internet or NAT gateway, regionally and only in the VCN's own region. The page excerpt retrieved does not name NoSQL Database Cloud Service. | <https://docs.oracle.com/iaas/Content/Network/Tasks/servicegateway.htm> | Access to Oracle Services: Service Gateway: "The traffic from the VCN to the Oracle service travels over the Oracle network fabric and never traverses the internet." | 2026-11-08 | VERIFIED |
|
|
78
|
+
| OCI-NOSQL-E124 | Oracle states it logs DDL API calls made to NoSQL tables and makes the logs available to the customer for auditing. | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/features-of-oracle-nosql-database-cloud-service.html> | Responsibility Model: Auditing: "Oracle is responsible for logging DDL API calls made to NoSQL Database tables and for making these logs available to you the customer for auditing purposes." | 2026-11-08 | VERIFIED |
|
|
79
|
+
| OCI-NOSQL-E125 | The OCI Audit service automatically records calls to supported OCI public API endpoints as log events (time, source, target, action, response); the page says currently all services support Audit logging and does not describe NoSQL row-level (data-plane) get/put/query auditing. | <https://docs.oracle.com/en-us/iaas/Content/Audit/Concepts/auditoverview.htm> | Overview of Audit: "automatically records calls to all supported Oracle Cloud Infrastructure public application programming interface (API) endpoints as log events" | 2026-11-08 | VERIFIED |
|
|
80
|
+
| OCI-NOSQL-E126 | No native on-demand, scheduled or point-in-time backup feature, no NDCS private-endpoint or public-access-disable setting, and no RPO/RTO figure were found on the NDCS pages searched (Features, Plan your service, Global Active Tables, Monitor, Policies, migrator, What's New, release notes). | <https://docs.oracle.com/en/cloud/paas/nosql-cloud/> | Get Started index: "NDCS is a fully managed database cloud service that is designed to handle large amounts of data at high velocity." | 2026-11-08 | UNVERIFIED |
|
|
81
|
+
| OCI-NOSQL-E901 | `oci iam tenancy get` returns tenancy information; used as the read-only identity check. | <https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/iam/tenancy/get.html> | Example using required parameter: "oci iam tenancy get --tenancy-id $tenancy_id" | 2026-11-09 | VERIFIED |
|
|
82
|
+
| OCI-NOSQL-E902 | `oci iam region-subscription list` lists the regions a tenancy is subscribed to. | <https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/iam/region-subscription/list.html> | Description: "Lists the region subscriptions for the specified tenancy." | 2026-11-09 | VERIFIED |
|
|
83
|
+
| OCI-NOSQL-E903 | `oci nosql table get` reads one NoSQL table by name or OCID. | <https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql/table/get.html> | Example using required parameter: "oci nosql table get --table-name-or-id $table_name_or_id" | 2026-11-09 | VERIFIED |
|
|
84
|
+
| OCI-NOSQL-E904 | `oci nosql table list` lists NoSQL tables in a compartment. | <https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql/table/list.html> | Example using required parameter: "oci nosql table list --compartment-id $compartment_id" | 2026-11-09 | VERIFIED |
|
|
85
|
+
| OCI-NOSQL-E905 | `oci nosql index list` lists the indexes on a NoSQL table. | <https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql/index/list.html> | Example using required parameter: "oci nosql index list --table-name-or-id $table_name_or_id" | 2026-11-09 | VERIFIED |
|
|
86
|
+
| OCI-NOSQL-E906 | `oci nosql table list-table-usage` returns table usage records over an optional time range. | <https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql/table/list-table-usage.html> | Example using required parameter: "oci nosql table list-table-usage --table-name-or-id $table_name_or_id" | 2026-11-09 | VERIFIED |
|
|
87
|
+
| OCI-NOSQL-E907 | `oci nosql work-request list` lists NoSQL work requests in a compartment. | <https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql/work-request/list.html> | Example using required parameter: "oci nosql work-request list --compartment-id $compartment_id" | 2026-11-09 | VERIFIED |
|
|
88
|
+
| OCI-NOSQL-E908 | `oci monitoring alarm list` lists the alarms in a compartment. | <https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/monitoring/alarm/list.html> | Description: "Lists the alarms for the specified compartment." | 2026-11-09 | VERIFIED |
|
|
89
|
+
| OCI-NOSQL-E909 | `oci audit event list` returns audit events for a compartment within a time range. | <https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/audit/event/list.html> | Description: "Returns all the audit events processed for the specified compartment within the specified time range." | 2026-11-09 | VERIFIED |
|
|
90
|
+
| OCI-NOSQL-E910 | `oci iam policy list` lists the IAM policies in a compartment. | <https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/iam/policy/list.html> | Description: "Lists the policies in the specified compartment (either the tenancy or another of your compartments)." | 2026-11-09 | VERIFIED |
|
|
91
|
+
| OCI-NOSQL-E911 | `oci monitoring metric list` returns metric definitions for a compartment, filterable by namespace. | <https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/monitoring/metric/list.html> | Example using required parameter: "oci monitoring metric list --compartment-id $compartment_id" | 2026-11-09 | VERIFIED |
|
|
92
|
+
| OCI-NOSQL-E912 | `oci network service-gateway list` lists the service gateways in a compartment. | <https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/network/service-gateway/list.html> | Description: "Lists the service gateways in the specified compartment." | 2026-11-09 | VERIFIED |
|
|
93
|
+
| OCI-NOSQL-E913 | `oci os object list` lists the objects in a bucket (names and selected metadata fields). | <https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/os/object/list.html> | Example using required parameter: "oci os object list --bucket-name bucket-client --fields name,md5" | 2026-11-09 | VERIFIED |
|
|
94
|
+
| OCI-NOSQL-E914 | Terraform `oci_nosql_table` resource arguments include `compartment_id`, `ddl_statement`, `defined_tags`, `freeform_tags`, `is_auto_reclaimable`, `name` and a `table_limits` block (`capacity_mode`, `max_read_units`, `max_write_units`, `max_storage_in_gbs`). | <https://github.com/oracle/terraform-provider-oci/blob/master/website/docs/r/nosql_table.html.markdown> | Argument Reference: "Throughput and storage limits configuration of a table." | 2026-11-09 | VERIFIED |
|
|
95
|
+
| OCI-NOSQL-E915 | OCI CLI responses are JSON by default, with results under a top-level data key, and resource objects carry an id field. | <https://docs.oracle.com/en-us/iaas/Content/API/SDKDocs/cliusing.htm> | Format Output as a Table: "By default, all responses to a command are returned in JSON format." | 2026-11-11 | VERIFIED |
|
|
96
|
+
| OCI-NOSQL-E916 | The Tenancy model's id attribute is the tenancy OCID. | <https://docs.oracle.com/en-us/iaas/tools/python/latest/api/identity/models/oci.identity.models.Tenancy.html> | id: "Gets the id of this Tenancy. The OCID of the tenancy." | 2026-11-11 | VERIFIED |
|
|
@@ -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.
|