rubydb 0.1.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.
- checksums.yaml +7 -0
- data/.gitattributes +20 -0
- data/.github/ISSUE_TEMPLATE/bug.yml +0 -0
- data/.github/ISSUE_TEMPLATE/feature.yml +0 -0
- data/.github/ISSUE_TEMPLATE/performance.yml +0 -0
- data/.github/ISSUE_TEMPLATE/security.yml +0 -0
- data/.github/PULL_REQUEST_TEMPLATE.md +15 -0
- data/.github/dependabot.yml +0 -0
- data/.github/workflows/benchmark.yml +26 -0
- data/.github/workflows/compatibility.yml +63 -0
- data/.github/workflows/fuzz.yml +33 -0
- data/.github/workflows/lint.yml +21 -0
- data/.github/workflows/operations.yml +24 -0
- data/.github/workflows/production-validation.yml +111 -0
- data/.github/workflows/release.yml +77 -0
- data/.github/workflows/security.yml +37 -0
- data/.github/workflows/test.yml +26 -0
- data/.github/workflows/workload.yml +58 -0
- data/.gitignore +43 -0
- data/.rspec +4 -0
- data/.rubocop.yml +44 -0
- data/.ruby-version +1 -0
- data/.standard.yml +14 -0
- data/ARCHITECTURE.md +21 -0
- data/CHANGELOG.md +31 -0
- data/CODE_OF_CONDUCT.md +13 -0
- data/CONTRIBUTING.md +29 -0
- data/GOVERNANCE.md +16 -0
- data/Gemfile +17 -0
- data/Gemfile.lock +71 -0
- data/LICENSE +60 -0
- data/README.md +162 -0
- data/ROADMAP.md +27 -0
- data/Rakefile +71 -0
- data/SECURITY.md +54 -0
- data/SUPPORT.md +14 -0
- data/adapters/activerecord/Gemfile +11 -0
- data/adapters/activerecord/README.md +9 -0
- data/adapters/activerecord/lib/active_record/connection_adapters/rubydb_adapter.rb +887 -0
- data/adapters/activerecord/rubydb-activerecord.gemspec +27 -0
- data/adapters/activerecord/spec/rubydb_adapter_integration_spec.rb +151 -0
- data/adapters/ruby/README.md +18 -0
- data/adapters/sequel/README.md +11 -0
- data/bin/rubydb +19 -0
- data/bin/rubydb-server +126 -0
- data/config/development.yml +0 -0
- data/config/monitoring/prometheus-alerts.yml +39 -0
- data/config/production.yml +36 -0
- data/config/test.yml +0 -0
- data/docs/README.md +71 -0
- data/docs/architecture/concurrency.md +14 -0
- data/docs/architecture/current-state.md +125 -0
- data/docs/architecture/execution-engine.md +25 -0
- data/docs/architecture/indexes.md +19 -0
- data/docs/architecture/mvcc.md +19 -0
- data/docs/architecture/overview.md +13 -0
- data/docs/architecture/pages.md +11 -0
- data/docs/architecture/production-roadmap.md +82 -0
- data/docs/architecture/query-planner.md +20 -0
- data/docs/architecture/recovery.md +18 -0
- data/docs/architecture/sql-engine.md +12 -0
- data/docs/architecture/storage-engine.md +14 -0
- data/docs/architecture/transactions.md +10 -0
- data/docs/architecture/wal.md +28 -0
- data/docs/cli-cheatsheet.md +98 -0
- data/docs/cli.md +275 -0
- data/docs/contributing/architecture.md +9 -0
- data/docs/contributing/benchmarking.md +14 -0
- data/docs/contributing/development.md +16 -0
- data/docs/contributing/release-process.md +49 -0
- data/docs/contributing/testing.md +16 -0
- data/docs/debugging.md +229 -0
- data/docs/developer/branching.md +10 -0
- data/docs/developer/database-diff.md +10 -0
- data/docs/developer/local-development.md +17 -0
- data/docs/developer/snapshots.md +9 -0
- data/docs/developer/temporal-data.md +10 -0
- data/docs/developer-guide.md +297 -0
- data/docs/getting-started/first-database.md +16 -0
- data/docs/getting-started/first-query.md +13 -0
- data/docs/getting-started/installation.md +19 -0
- data/docs/getting-started/local-to-production.md +300 -0
- data/docs/getting-started/quickstart.md +17 -0
- data/docs/getting-started/rails.md +16 -0
- data/docs/hardening_backlog.md +93 -0
- data/docs/lessons-learned.md +112 -0
- data/docs/operations/backups.md +33 -0
- data/docs/operations/disaster-recovery.md +31 -0
- data/docs/operations/failover.md +30 -0
- data/docs/operations/monitoring.md +25 -0
- data/docs/operations/production-guide.md +295 -0
- data/docs/operations/production-runbook.md +45 -0
- data/docs/operations/replication.md +33 -0
- data/docs/operations/restore.md +6 -0
- data/docs/operations/runbook.md +34 -0
- data/docs/operations/upgrades.md +14 -0
- data/docs/operations/workload-testing.md +17 -0
- data/docs/production-readiness.md +118 -0
- data/docs/production_validation.md +150 -0
- data/docs/rails/active-record.md +11 -0
- data/docs/rails/compatibility-guide.md +90 -0
- data/docs/rails/database-yml.md +92 -0
- data/docs/rails/installation.md +17 -0
- data/docs/rails/migrations.md +17 -0
- data/docs/rails/production.md +82 -0
- data/docs/rails/troubleshooting.md +18 -0
- data/docs/release.md +59 -0
- data/docs/server/architecture.md +10 -0
- data/docs/server/authentication.md +10 -0
- data/docs/server/configuration.md +16 -0
- data/docs/server/connection-pooling.md +10 -0
- data/docs/server/deployment.md +10 -0
- data/docs/server/protocol.md +12 -0
- data/docs/sql/compatibility-guide.md +82 -0
- data/docs/sql/compatibility.md +39 -0
- data/docs/sql/data-types.md +10 -0
- data/docs/sql/functions.md +9 -0
- data/docs/sql/joins.md +9 -0
- data/docs/sql/operators.md +9 -0
- data/docs/sql/sqlite-compatibility.md +21 -0
- data/docs/sql/syntax.md +10 -0
- data/docs/sql/transactions.md +10 -0
- data/docs/troubleshooting.md +244 -0
- data/exe/rubydb +23 -0
- data/lib/rubydb/backup/archive.rb +334 -0
- data/lib/rubydb/backup/backup.rb +401 -0
- data/lib/rubydb/backup/incremental.rb +353 -0
- data/lib/rubydb/backup/restore.rb +290 -0
- data/lib/rubydb/backup/snapshot.rb +267 -0
- data/lib/rubydb/backup/verification.rb +279 -0
- data/lib/rubydb/branching/branch.rb +181 -0
- data/lib/rubydb/branching/branch_manager.rb +311 -0
- data/lib/rubydb/branching/branch_metadata.rb +140 -0
- data/lib/rubydb/branching/checkout.rb +166 -0
- data/lib/rubydb/branching/copy_on_write.rb +272 -0
- data/lib/rubydb/branching/diff.rb +138 -0
- data/lib/rubydb/branching/merge.rb +285 -0
- data/lib/rubydb/build_info.rb +15 -0
- data/lib/rubydb/catalog/catalog.rb +391 -0
- data/lib/rubydb/catalog/column.rb +112 -0
- data/lib/rubydb/catalog/constraint.rb +180 -0
- data/lib/rubydb/catalog/database.rb +184 -0
- data/lib/rubydb/catalog/index.rb +97 -0
- data/lib/rubydb/catalog/schema.rb +103 -0
- data/lib/rubydb/catalog/sequence.rb +90 -0
- data/lib/rubydb/catalog/system_catalog.rb +698 -0
- data/lib/rubydb/catalog/table.rb +178 -0
- data/lib/rubydb/catalog/trigger.rb +102 -0
- data/lib/rubydb/catalog/view.rb +66 -0
- data/lib/rubydb/cli/application.rb +163 -0
- data/lib/rubydb/cli/commands/backup.rb +81 -0
- data/lib/rubydb/cli/commands/branch.rb +72 -0
- data/lib/rubydb/cli/commands/checkout.rb +54 -0
- data/lib/rubydb/cli/commands/create.rb +58 -0
- data/lib/rubydb/cli/commands/diff.rb +77 -0
- data/lib/rubydb/cli/commands/doctor.rb +74 -0
- data/lib/rubydb/cli/commands/drop.rb +57 -0
- data/lib/rubydb/cli/commands/init.rb +102 -0
- data/lib/rubydb/cli/commands/inspect.rb +95 -0
- data/lib/rubydb/cli/commands/merge.rb +63 -0
- data/lib/rubydb/cli/commands/migrate.rb +62 -0
- data/lib/rubydb/cli/commands/restart.rb +39 -0
- data/lib/rubydb/cli/commands/restore.rb +121 -0
- data/lib/rubydb/cli/commands/shell.rb +365 -0
- data/lib/rubydb/cli/commands/snapshot.rb +79 -0
- data/lib/rubydb/cli/commands/start.rb +82 -0
- data/lib/rubydb/cli/commands/status.rb +92 -0
- data/lib/rubydb/cli/commands/stop.rb +47 -0
- data/lib/rubydb/cli/commands/vacuum.rb +58 -0
- data/lib/rubydb/cli/formatter.rb +221 -0
- data/lib/rubydb/cli/output.rb +168 -0
- data/lib/rubydb/client/client.rb +304 -0
- data/lib/rubydb/client/connection.rb +415 -0
- data/lib/rubydb/client/connection_pool.rb +168 -0
- data/lib/rubydb/client/connection_url.rb +96 -0
- data/lib/rubydb/client/prepared_statement.rb +60 -0
- data/lib/rubydb/client/result.rb +123 -0
- data/lib/rubydb/client/statement.rb +52 -0
- data/lib/rubydb/client/transaction.rb +130 -0
- data/lib/rubydb/concurrency/concurrency.rb +19 -0
- data/lib/rubydb/concurrency/deadlock_detector.rb +150 -0
- data/lib/rubydb/concurrency/latch.rb +101 -0
- data/lib/rubydb/concurrency/lock_graph.rb +165 -0
- data/lib/rubydb/concurrency/mutex.rb +183 -0
- data/lib/rubydb/concurrency/rw_lock.rb +180 -0
- data/lib/rubydb/concurrency/scheduler.rb +250 -0
- data/lib/rubydb/concurrency/worker_pool.rb +143 -0
- data/lib/rubydb/configuration/config.rb +170 -0
- data/lib/rubydb/configuration/defaults.rb +179 -0
- data/lib/rubydb/configuration/environment.rb +152 -0
- data/lib/rubydb/configuration/parser.rb +185 -0
- data/lib/rubydb/configuration/validation.rb +221 -0
- data/lib/rubydb/constants.rb +74 -0
- data/lib/rubydb/constraints/check.rb +181 -0
- data/lib/rubydb/constraints/constraint.rb +101 -0
- data/lib/rubydb/constraints/foreign_key.rb +130 -0
- data/lib/rubydb/constraints/not_null.rb +64 -0
- data/lib/rubydb/constraints/primary_key.rb +99 -0
- data/lib/rubydb/constraints/unique.rb +108 -0
- data/lib/rubydb/constraints/validator.rb +350 -0
- data/lib/rubydb/errors/authentication_error.rb +10 -0
- data/lib/rubydb/errors/authorization_error.rb +23 -0
- data/lib/rubydb/errors/client_error.rb +10 -0
- data/lib/rubydb/errors/configuration_error.rb +10 -0
- data/lib/rubydb/errors/connection_error.rb +10 -0
- data/lib/rubydb/errors/constraint_error.rb +23 -0
- data/lib/rubydb/errors/corruption_error.rb +10 -0
- data/lib/rubydb/errors/database_error.rb +10 -0
- data/lib/rubydb/errors/error.rb +20 -0
- data/lib/rubydb/errors/execution_error.rb +10 -0
- data/lib/rubydb/errors/parser_error.rb +10 -0
- data/lib/rubydb/errors/recovery_error.rb +10 -0
- data/lib/rubydb/errors/replication_error.rb +10 -0
- data/lib/rubydb/errors/server_error.rb +6 -0
- data/lib/rubydb/errors/storage_error.rb +10 -0
- data/lib/rubydb/errors/transaction_error.rb +10 -0
- data/lib/rubydb/execution/aggregate_executor.rb +138 -0
- data/lib/rubydb/execution/delete_executor.rb +112 -0
- data/lib/rubydb/execution/distinct_executor.rb +135 -0
- data/lib/rubydb/execution/executor.rb +1192 -0
- data/lib/rubydb/execution/expression.rb +193 -0
- data/lib/rubydb/execution/index_scan.rb +142 -0
- data/lib/rubydb/execution/insert_executor.rb +217 -0
- data/lib/rubydb/execution/join_executor.rb +249 -0
- data/lib/rubydb/execution/limit_executor.rb +85 -0
- data/lib/rubydb/execution/optimizer.rb +215 -0
- data/lib/rubydb/execution/plan.rb +361 -0
- data/lib/rubydb/execution/planner.rb +546 -0
- data/lib/rubydb/execution/predicate.rb +235 -0
- data/lib/rubydb/execution/scan.rb +49 -0
- data/lib/rubydb/execution/sequential_scan.rb +63 -0
- data/lib/rubydb/execution/sort_executor.rb +185 -0
- data/lib/rubydb/execution/update_executor.rb +162 -0
- data/lib/rubydb/functions/aggregate.rb +70 -0
- data/lib/rubydb/functions/date_functions.rb +278 -0
- data/lib/rubydb/functions/function.rb +85 -0
- data/lib/rubydb/functions/json_functions.rb +215 -0
- data/lib/rubydb/functions/numeric_functions.rb +346 -0
- data/lib/rubydb/functions/scalar.rb +52 -0
- data/lib/rubydb/functions/string_functions.rb +383 -0
- data/lib/rubydb/functions/system_functions.rb +246 -0
- data/lib/rubydb/history/as_of.rb +238 -0
- data/lib/rubydb/history/change.rb +105 -0
- data/lib/rubydb/history/history.rb +131 -0
- data/lib/rubydb/history/history_manager.rb +229 -0
- data/lib/rubydb/history/temporal_query.rb +202 -0
- data/lib/rubydb/history/timeline.rb +144 -0
- data/lib/rubydb/indexes/btree.rb +186 -0
- data/lib/rubydb/indexes/btree_cursor.rb +258 -0
- data/lib/rubydb/indexes/btree_node.rb +385 -0
- data/lib/rubydb/indexes/hash_index.rb +150 -0
- data/lib/rubydb/indexes/index.rb +71 -0
- data/lib/rubydb/indexes/index_manager.rb +406 -0
- data/lib/rubydb/indexes/index_scan.rb +470 -0
- data/lib/rubydb/migrations/migration.rb +254 -0
- data/lib/rubydb/migrations/migration_lock.rb +146 -0
- data/lib/rubydb/migrations/migration_manager.rb +176 -0
- data/lib/rubydb/migrations/migration_version.rb +71 -0
- data/lib/rubydb/migrations/schema_diff.rb +211 -0
- data/lib/rubydb/migrations/schema_version.rb +64 -0
- data/lib/rubydb/monitoring/events.rb +160 -0
- data/lib/rubydb/monitoring/health.rb +222 -0
- data/lib/rubydb/monitoring/logger.rb +193 -0
- data/lib/rubydb/monitoring/metrics.rb +359 -0
- data/lib/rubydb/monitoring/performance.rb +176 -0
- data/lib/rubydb/monitoring/statistics.rb +170 -0
- data/lib/rubydb/mvcc/garbage_collector.rb +199 -0
- data/lib/rubydb/mvcc/mvcc.rb +16 -0
- data/lib/rubydb/mvcc/snapshot.rb +147 -0
- data/lib/rubydb/mvcc/vacuum.rb +180 -0
- data/lib/rubydb/mvcc/version.rb +106 -0
- data/lib/rubydb/mvcc/version_store.rb +398 -0
- data/lib/rubydb/mvcc/visibility.rb +109 -0
- data/lib/rubydb/protocol/capabilities.rb +125 -0
- data/lib/rubydb/protocol/decoder.rb +145 -0
- data/lib/rubydb/protocol/encoder.rb +136 -0
- data/lib/rubydb/protocol/handshake.rb +305 -0
- data/lib/rubydb/protocol/message.rb +121 -0
- data/lib/rubydb/protocol/protocol.rb +277 -0
- data/lib/rubydb/protocol/version.rb +54 -0
- data/lib/rubydb/rails/adapter.rb +239 -0
- data/lib/rubydb/rails/connection.rb +314 -0
- data/lib/rubydb/rails/database_statements.rb +122 -0
- data/lib/rubydb/rails/migration.rb +131 -0
- data/lib/rubydb/rails/quoting.rb +109 -0
- data/lib/rubydb/rails/result.rb +120 -0
- data/lib/rubydb/rails/schema_statements.rb +339 -0
- data/lib/rubydb/rails/transaction.rb +105 -0
- data/lib/rubydb/rails/type.rb +126 -0
- data/lib/rubydb/recovery/checkpoint.rb +257 -0
- data/lib/rubydb/recovery/consistency.rb +467 -0
- data/lib/rubydb/recovery/corruption_detector.rb +5 -0
- data/lib/rubydb/recovery/crash_recovery.rb +387 -0
- data/lib/rubydb/recovery/recovery_manager.rb +206 -0
- data/lib/rubydb/recovery/redo.rb +237 -0
- data/lib/rubydb/recovery/undo.rb +206 -0
- data/lib/rubydb/replication/failover.rb +5 -0
- data/lib/rubydb/replication/fencing.rb +63 -0
- data/lib/rubydb/replication/primary.rb +450 -0
- data/lib/rubydb/replication/replica.rb +384 -0
- data/lib/rubydb/replication/replication_log.rb +200 -0
- data/lib/rubydb/replication/replication_manager.rb +308 -0
- data/lib/rubydb/replication/replication_slot.rb +295 -0
- data/lib/rubydb/replication/replication_stream.rb +201 -0
- data/lib/rubydb/rubydb.rb +560 -0
- data/lib/rubydb/security/access_control.rb +254 -0
- data/lib/rubydb/security/audit_log.rb +213 -0
- data/lib/rubydb/security/authentication.rb +302 -0
- data/lib/rubydb/security/authorization.rb +282 -0
- data/lib/rubydb/security/credentials.rb +196 -0
- data/lib/rubydb/security/password.rb +215 -0
- data/lib/rubydb/security/permissions.rb +74 -0
- data/lib/rubydb/security/role.rb +101 -0
- data/lib/rubydb/security/user.rb +86 -0
- data/lib/rubydb/server/connection.rb +366 -0
- data/lib/rubydb/server/connection_pool.rb +193 -0
- data/lib/rubydb/server/lifecycle.rb +228 -0
- data/lib/rubydb/server/listener.rb +136 -0
- data/lib/rubydb/server/request_handler.rb +276 -0
- data/lib/rubydb/server/server.rb +364 -0
- data/lib/rubydb/server/session.rb +369 -0
- data/lib/rubydb/server/worker.rb +210 -0
- data/lib/rubydb/server/worker_pool.rb +168 -0
- data/lib/rubydb/sql/ast/alter_table.rb +169 -0
- data/lib/rubydb/sql/ast/begin_transaction.rb +47 -0
- data/lib/rubydb/sql/ast/commit.rb +37 -0
- data/lib/rubydb/sql/ast/constraint.rb +83 -0
- data/lib/rubydb/sql/ast/create_database.rb +41 -0
- data/lib/rubydb/sql/ast/create_index.rb +61 -0
- data/lib/rubydb/sql/ast/create_schema.rb +52 -0
- data/lib/rubydb/sql/ast/create_table.rb +187 -0
- data/lib/rubydb/sql/ast/delete.rb +54 -0
- data/lib/rubydb/sql/ast/drop_database.rb +41 -0
- data/lib/rubydb/sql/ast/drop_index.rb +41 -0
- data/lib/rubydb/sql/ast/drop_schema.rb +49 -0
- data/lib/rubydb/sql/ast/drop_table.rb +49 -0
- data/lib/rubydb/sql/ast/explain.rb +64 -0
- data/lib/rubydb/sql/ast/expression.rb +604 -0
- data/lib/rubydb/sql/ast/insert.rb +82 -0
- data/lib/rubydb/sql/ast/node.rb +42 -0
- data/lib/rubydb/sql/ast/rollback.rb +63 -0
- data/lib/rubydb/sql/ast/savepoint.rb +59 -0
- data/lib/rubydb/sql/ast/select.rb +88 -0
- data/lib/rubydb/sql/ast/set_operation.rb +20 -0
- data/lib/rubydb/sql/ast/trigger.rb +29 -0
- data/lib/rubydb/sql/ast/update.rb +88 -0
- data/lib/rubydb/sql/ast/vacuum.rb +19 -0
- data/lib/rubydb/sql/ast/view.rb +32 -0
- data/lib/rubydb/sql/ast/with.rb +32 -0
- data/lib/rubydb/sql/grammar.rb +86 -0
- data/lib/rubydb/sql/keywords.rb +156 -0
- data/lib/rubydb/sql/lexer.rb +214 -0
- data/lib/rubydb/sql/operators.rb +100 -0
- data/lib/rubydb/sql/parser.rb +1185 -0
- data/lib/rubydb/sql/planner/analyzer.rb +302 -0
- data/lib/rubydb/sql/planner/binder.rb +550 -0
- data/lib/rubydb/sql/planner/type_checker.rb +431 -0
- data/lib/rubydb/sql/token.rb +210 -0
- data/lib/rubydb/storage/buffer_frame.rb +44 -0
- data/lib/rubydb/storage/buffer_pool.rb +155 -0
- data/lib/rubydb/storage/database_lock.rb +74 -0
- data/lib/rubydb/storage/deserializer.rb +342 -0
- data/lib/rubydb/storage/engine.rb +2338 -0
- data/lib/rubydb/storage/file_manager.rb +187 -0
- data/lib/rubydb/storage/free_space_map.rb +81 -0
- data/lib/rubydb/storage/page.rb +94 -0
- data/lib/rubydb/storage/page_allocator.rb +855 -0
- data/lib/rubydb/storage/page_header.rb +67 -0
- data/lib/rubydb/storage/page_manager.rb +131 -0
- data/lib/rubydb/storage/record.rb +58 -0
- data/lib/rubydb/storage/row.rb +78 -0
- data/lib/rubydb/storage/serializer.rb +51 -0
- data/lib/rubydb/storage/storage_layout.rb +151 -0
- data/lib/rubydb/storage/storage_manager.rb +114 -0
- data/lib/rubydb/storage/tuple.rb +461 -0
- data/lib/rubydb/storage/visibility_map.rb +984 -0
- data/lib/rubydb/transactions/commit_manager.rb +220 -0
- data/lib/rubydb/transactions/isolation.rb +98 -0
- data/lib/rubydb/transactions/lock.rb +76 -0
- data/lib/rubydb/transactions/lock_manager.rb +362 -0
- data/lib/rubydb/transactions/savepoint.rb +143 -0
- data/lib/rubydb/transactions/transaction.rb +215 -0
- data/lib/rubydb/transactions/transaction_id.rb +84 -0
- data/lib/rubydb/transactions/transaction_log.rb +257 -0
- data/lib/rubydb/transactions/transaction_manager.rb +435 -0
- data/lib/rubydb/types/bigint.rb +36 -0
- data/lib/rubydb/types/blob.rb +37 -0
- data/lib/rubydb/types/boolean.rb +34 -0
- data/lib/rubydb/types/date.rb +39 -0
- data/lib/rubydb/types/decimal.rb +48 -0
- data/lib/rubydb/types/float.rb +34 -0
- data/lib/rubydb/types/integer.rb +36 -0
- data/lib/rubydb/types/json.rb +41 -0
- data/lib/rubydb/types/null.rb +34 -0
- data/lib/rubydb/types/smallint.rb +36 -0
- data/lib/rubydb/types/text.rb +37 -0
- data/lib/rubydb/types/time.rb +46 -0
- data/lib/rubydb/types/timestamp.rb +39 -0
- data/lib/rubydb/types/type.rb +119 -0
- data/lib/rubydb/types/uuid.rb +47 -0
- data/lib/rubydb/types/varchar.rb +37 -0
- data/lib/rubydb/version.rb +33 -0
- data/lib/rubydb/wal/archive.rb +193 -0
- data/lib/rubydb/wal/checkpoint.rb +183 -0
- data/lib/rubydb/wal/lsn.rb +94 -0
- data/lib/rubydb/wal/reader.rb +260 -0
- data/lib/rubydb/wal/record.rb +105 -0
- data/lib/rubydb/wal/segment.rb +193 -0
- data/lib/rubydb/wal/wal.rb +452 -0
- data/lib/rubydb/wal/writer.rb +236 -0
- data/lib/rubydb.rb +7 -0
- data/packaging/docker/Dockerfile +36 -0
- data/packaging/docker/docker-compose.failover.yml +43 -0
- data/packaging/docker/entrypoint.sh +15 -0
- data/packaging/homebrew/rubydb.rb +19 -0
- data/packaging/systemd/rubydb.service +22 -0
- data/rubydb.gemspec +57 -0
- data/scripts/benchmark +7 -0
- data/scripts/durability_drill +37 -0
- data/scripts/format +0 -0
- data/scripts/fuzz +63 -0
- data/scripts/lint +0 -0
- data/scripts/release +50 -0
- data/scripts/release_check +43 -0
- data/scripts/replication_failover_drill +250 -0
- data/scripts/replication_network_failover_drill +255 -0
- data/scripts/restore_drill +45 -0
- data/scripts/security +0 -0
- data/scripts/setup +0 -0
- data/scripts/test +0 -0
- data/scripts/test-chaos +0 -0
- data/scripts/test-crash +0 -0
- data/scripts/test-integration +0 -0
- data/scripts/test-unit +0 -0
- data/visibility_map.json +1 -0
- metadata +538 -0
|
@@ -0,0 +1,364 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
require "socket"
|
|
4
|
+
require "thread"
|
|
5
|
+
require "time"
|
|
6
|
+
require "json"
|
|
7
|
+
require "fileutils"
|
|
8
|
+
require "monitor"
|
|
9
|
+
require "openssl"
|
|
10
|
+
|
|
11
|
+
require_relative "listener"
|
|
12
|
+
require_relative "connection"
|
|
13
|
+
require_relative "session"
|
|
14
|
+
require_relative "connection_pool"
|
|
15
|
+
require_relative "worker_pool"
|
|
16
|
+
require_relative "worker"
|
|
17
|
+
require_relative "request_handler"
|
|
18
|
+
require_relative "lifecycle"
|
|
19
|
+
require_relative "../protocol/protocol"
|
|
20
|
+
require_relative "../protocol/handshake"
|
|
21
|
+
require_relative "../storage/engine"
|
|
22
|
+
require_relative "../transactions/transaction_manager"
|
|
23
|
+
|
|
24
|
+
module RubyDB
|
|
25
|
+
module Server
|
|
26
|
+
# Server - Main database server
|
|
27
|
+
class Server
|
|
28
|
+
attr_reader :config, :engine, :listener, :connection_pool
|
|
29
|
+
attr_reader :worker_pool, :request_handler, :lifecycle, :stats
|
|
30
|
+
|
|
31
|
+
def initialize(config = {})
|
|
32
|
+
@config = {
|
|
33
|
+
host: config[:host] || "localhost",
|
|
34
|
+
port: config[:port] || 7432,
|
|
35
|
+
max_connections: config[:max_connections] || 100,
|
|
36
|
+
min_workers: config[:min_workers] || 2,
|
|
37
|
+
max_workers: config[:max_workers] || 20,
|
|
38
|
+
worker_queue_size: config[:worker_queue_size] || 1000,
|
|
39
|
+
read_timeout: config[:read_timeout] || 30,
|
|
40
|
+
write_timeout: config[:write_timeout] || 30,
|
|
41
|
+
idle_timeout: config[:idle_timeout] || 300,
|
|
42
|
+
max_request_size: config[:max_request_size] || 10 * 1024 * 1024, # 10MB
|
|
43
|
+
data_dir: config[:data_dir] || "data",
|
|
44
|
+
log_dir: config[:log_dir] || "log",
|
|
45
|
+
pid_file: config[:pid_file] || "rubydb.pid",
|
|
46
|
+
daemonize: config[:daemonize] || false,
|
|
47
|
+
authentication: config[:authentication] || { method: "none" },
|
|
48
|
+
ssl: config[:ssl] || { enabled: false }
|
|
49
|
+
}.merge(config)
|
|
50
|
+
|
|
51
|
+
@stats = {
|
|
52
|
+
connections_total: 0,
|
|
53
|
+
connections_active: 0,
|
|
54
|
+
connections_rejected: 0,
|
|
55
|
+
requests_processed: 0,
|
|
56
|
+
requests_failed: 0,
|
|
57
|
+
bytes_received: 0,
|
|
58
|
+
bytes_sent: 0,
|
|
59
|
+
started_at: nil,
|
|
60
|
+
uptime_seconds: 0,
|
|
61
|
+
last_activity: nil
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
@lock = Monitor.new
|
|
65
|
+
@running = false
|
|
66
|
+
@shutdown = false
|
|
67
|
+
@stopping = false
|
|
68
|
+
|
|
69
|
+
validate_authentication_config!
|
|
70
|
+
validate_ssl_config!
|
|
71
|
+
validate_resource_limits!
|
|
72
|
+
|
|
73
|
+
# Setup directories
|
|
74
|
+
setup_directories
|
|
75
|
+
|
|
76
|
+
# Initialize components
|
|
77
|
+
initialize_components
|
|
78
|
+
end
|
|
79
|
+
|
|
80
|
+
def start
|
|
81
|
+
@lock.synchronize do
|
|
82
|
+
return if @running
|
|
83
|
+
|
|
84
|
+
@running = true
|
|
85
|
+
@shutdown = false
|
|
86
|
+
@stats[:started_at] = Time.now
|
|
87
|
+
|
|
88
|
+
# Daemonize if configured
|
|
89
|
+
daemonize if @config[:daemonize]
|
|
90
|
+
|
|
91
|
+
# Write PID file
|
|
92
|
+
write_pid_file
|
|
93
|
+
|
|
94
|
+
# Start components
|
|
95
|
+
@listener.start
|
|
96
|
+
@connection_pool.start
|
|
97
|
+
@worker_pool.start
|
|
98
|
+
@lifecycle.start
|
|
99
|
+
|
|
100
|
+
puts "RubyDB Server v#{RubyDB::VERSION} started on #{@config[:host]}:#{@config[:port]}"
|
|
101
|
+
puts "Data directory: #{@config[:data_dir]}"
|
|
102
|
+
puts "Max connections: #{@config[:max_connections]}"
|
|
103
|
+
|
|
104
|
+
# Update stats thread
|
|
105
|
+
start_stats_thread
|
|
106
|
+
|
|
107
|
+
true
|
|
108
|
+
end
|
|
109
|
+
end
|
|
110
|
+
|
|
111
|
+
def stop
|
|
112
|
+
@lock.synchronize do
|
|
113
|
+
return unless @running
|
|
114
|
+
return true if @stopping
|
|
115
|
+
|
|
116
|
+
@stopping = true
|
|
117
|
+
|
|
118
|
+
@shutdown = true
|
|
119
|
+
puts "Shutting down RubyDB Server..."
|
|
120
|
+
|
|
121
|
+
# Stop accepting new connections
|
|
122
|
+
@listener.stop
|
|
123
|
+
|
|
124
|
+
# Close all connections
|
|
125
|
+
@connection_pool.close_all
|
|
126
|
+
|
|
127
|
+
# Stop workers
|
|
128
|
+
@worker_pool.stop
|
|
129
|
+
|
|
130
|
+
# Stop lifecycle
|
|
131
|
+
@lifecycle.stop
|
|
132
|
+
|
|
133
|
+
# Release the database file handle before the data directory is
|
|
134
|
+
# removed by callers (notably on Windows).
|
|
135
|
+
@engine&.close
|
|
136
|
+
|
|
137
|
+
# Remove PID file
|
|
138
|
+
remove_pid_file
|
|
139
|
+
|
|
140
|
+
@running = false
|
|
141
|
+
@stopping = false
|
|
142
|
+
|
|
143
|
+
puts "RubyDB Server stopped"
|
|
144
|
+
true
|
|
145
|
+
end
|
|
146
|
+
end
|
|
147
|
+
|
|
148
|
+
def restart
|
|
149
|
+
stop
|
|
150
|
+
sleep(1)
|
|
151
|
+
start
|
|
152
|
+
end
|
|
153
|
+
|
|
154
|
+
def running?
|
|
155
|
+
@running
|
|
156
|
+
end
|
|
157
|
+
|
|
158
|
+
def stats
|
|
159
|
+
@lock.synchronize do
|
|
160
|
+
elapsed = @stats[:started_at] ? (Time.now - @stats[:started_at]).to_i : 0
|
|
161
|
+
@stats[:uptime_seconds] = elapsed
|
|
162
|
+
pool_stats = @connection_pool&.stats || {}
|
|
163
|
+
@stats[:connections_active] = pool_stats[:active_connections] || 0
|
|
164
|
+
@stats[:connections_total] = pool_stats[:total_connections] || 0
|
|
165
|
+
@stats[:requests_processed] = pool_stats[:requests_processed] || 0
|
|
166
|
+
@stats[:requests_failed] = pool_stats[:requests_failed] || 0
|
|
167
|
+
|
|
168
|
+
@stats.merge({
|
|
169
|
+
engine_stats: @engine&.stats || {},
|
|
170
|
+
connection_pool_stats: @connection_pool&.stats || {},
|
|
171
|
+
worker_pool_stats: @worker_pool&.stats || {},
|
|
172
|
+
memory_usage: get_memory_usage,
|
|
173
|
+
pid: Process.pid
|
|
174
|
+
})
|
|
175
|
+
end
|
|
176
|
+
end
|
|
177
|
+
|
|
178
|
+
private
|
|
179
|
+
|
|
180
|
+
def initialize_components
|
|
181
|
+
# Initialize storage engine
|
|
182
|
+
db_path = File.join(@config[:data_dir], "rubydb.rdb")
|
|
183
|
+
@engine = Storage::Engine.new(db_path, @config)
|
|
184
|
+
|
|
185
|
+
# Initialize transaction manager
|
|
186
|
+
@transaction_manager = Transactions::TransactionManager.new(@engine, @config)
|
|
187
|
+
|
|
188
|
+
# Initialize protocol
|
|
189
|
+
@protocol = Protocol::Protocol.new(
|
|
190
|
+
format: :json,
|
|
191
|
+
compression: @config[:compression] || false,
|
|
192
|
+
server_info: {
|
|
193
|
+
version: RubyDB::VERSION,
|
|
194
|
+
pid: Process.pid,
|
|
195
|
+
started_at: Time.now.iso8601,
|
|
196
|
+
default_auth: authentication_method,
|
|
197
|
+
authentication_credentials: authentication_credentials
|
|
198
|
+
}
|
|
199
|
+
)
|
|
200
|
+
|
|
201
|
+
# Initialize connection pool
|
|
202
|
+
@connection_pool = ConnectionPool.new(@config, @protocol, @engine)
|
|
203
|
+
|
|
204
|
+
# Initialize worker pool
|
|
205
|
+
@worker_pool = WorkerPool.new(@config, @engine, @transaction_manager)
|
|
206
|
+
|
|
207
|
+
# Initialize request handler
|
|
208
|
+
@request_handler = RequestHandler.new(@engine, @transaction_manager, @config)
|
|
209
|
+
|
|
210
|
+
# Initialize listener
|
|
211
|
+
@listener = Listener.new(@config, @connection_pool, @worker_pool)
|
|
212
|
+
|
|
213
|
+
# Initialize lifecycle
|
|
214
|
+
@lifecycle = Lifecycle.new(self, @config)
|
|
215
|
+
end
|
|
216
|
+
|
|
217
|
+
def setup_directories
|
|
218
|
+
[:data_dir, :log_dir].each do |dir|
|
|
219
|
+
path = @config[dir]
|
|
220
|
+
FileUtils.mkdir_p(path) unless Dir.exist?(path)
|
|
221
|
+
end
|
|
222
|
+
end
|
|
223
|
+
|
|
224
|
+
def authentication_method
|
|
225
|
+
auth = @config[:authentication] || {}
|
|
226
|
+
(auth[:method] || auth["method"] || "none").to_s.tr("_", "-")
|
|
227
|
+
end
|
|
228
|
+
|
|
229
|
+
def authentication_credentials
|
|
230
|
+
auth = @config[:authentication] || {}
|
|
231
|
+
auth[:credentials] || auth["credentials"] || auth
|
|
232
|
+
end
|
|
233
|
+
|
|
234
|
+
def validate_authentication_config!
|
|
235
|
+
method = authentication_method
|
|
236
|
+
supported = %w[none password md5 scram-sha-256]
|
|
237
|
+
raise ServerError, "Unsupported authentication method: #{method}" unless supported.include?(method)
|
|
238
|
+
|
|
239
|
+
return if method == "none"
|
|
240
|
+
|
|
241
|
+
credentials = authentication_credentials
|
|
242
|
+
users = credentials[:users] || credentials["users"]
|
|
243
|
+
complete = users && !users.empty? ||
|
|
244
|
+
((credentials[:username] || credentials["username"]) &&
|
|
245
|
+
(credentials[:password] || credentials["password"]))
|
|
246
|
+
raise ServerError, "Authentication credentials are required for #{method}" unless complete
|
|
247
|
+
end
|
|
248
|
+
|
|
249
|
+
def validate_ssl_config!
|
|
250
|
+
ssl = @config[:ssl] || {}
|
|
251
|
+
enabled = ssl == true || ssl[:enabled] || ssl["enabled"]
|
|
252
|
+
return unless enabled
|
|
253
|
+
|
|
254
|
+
raise ServerError, "SSL configuration must include certificate and key paths" if ssl == true
|
|
255
|
+
|
|
256
|
+
cert = ssl[:cert_file] || ssl["cert_file"]
|
|
257
|
+
key = ssl[:key_file] || ssl["key_file"]
|
|
258
|
+
raise ServerError, "ssl.cert_file and ssl.key_file are required when SSL is enabled" unless cert && key
|
|
259
|
+
raise ServerError, "SSL certificate file does not exist" unless File.file?(cert)
|
|
260
|
+
raise ServerError, "SSL key file does not exist" unless File.file?(key)
|
|
261
|
+
|
|
262
|
+
begin
|
|
263
|
+
OpenSSL::X509::Certificate.new(File.binread(cert))
|
|
264
|
+
OpenSSL::PKey.read(File.binread(key))
|
|
265
|
+
rescue OpenSSL::SSL::SSLError, OpenSSL::X509::CertificateError, OpenSSL::PKey::PKeyError, ArgumentError => e
|
|
266
|
+
raise ServerError, "SSL certificate or key is invalid: #{e.message}"
|
|
267
|
+
end
|
|
268
|
+
|
|
269
|
+
ca = ssl[:ca_file] || ssl["ca_file"]
|
|
270
|
+
if (ssl[:verify_peer] || ssl["verify_peer"]) && !ca
|
|
271
|
+
raise ServerError, "ssl.ca_file is required when peer verification is enabled"
|
|
272
|
+
end
|
|
273
|
+
raise ServerError, "SSL CA file does not exist" if ca && !File.file?(ca)
|
|
274
|
+
|
|
275
|
+
min_version = ssl[:min_version] || ssl["min_version"] || :TLS1_2
|
|
276
|
+
unless %i[TLS1_2 TLS1_3].include?(min_version.to_s.to_sym)
|
|
277
|
+
raise ServerError, "SSL min_version must be TLS1_2 or TLS1_3"
|
|
278
|
+
end
|
|
279
|
+
end
|
|
280
|
+
|
|
281
|
+
def validate_resource_limits!
|
|
282
|
+
integer_limits = {
|
|
283
|
+
max_connections: 1..10_000,
|
|
284
|
+
min_workers: 1..1_024,
|
|
285
|
+
max_workers: 1..1_024,
|
|
286
|
+
worker_queue_size: 1..100_000,
|
|
287
|
+
max_request_size: 1_024..(64 * 1024 * 1024)
|
|
288
|
+
}
|
|
289
|
+
integer_limits.each do |name, allowed|
|
|
290
|
+
value = Integer(@config[name])
|
|
291
|
+
raise ServerError, "#{name} must be between #{allowed.begin} and #{allowed.end}" unless allowed.cover?(value)
|
|
292
|
+
@config[name] = value
|
|
293
|
+
rescue ArgumentError, TypeError
|
|
294
|
+
raise ServerError, "#{name} must be an integer"
|
|
295
|
+
end
|
|
296
|
+
raise ServerError, "min_workers cannot exceed max_workers" if @config[:min_workers] > @config[:max_workers]
|
|
297
|
+
|
|
298
|
+
%i[read_timeout write_timeout idle_timeout].each do |name|
|
|
299
|
+
value = Float(@config[name])
|
|
300
|
+
raise ServerError, "#{name} must be greater than zero" unless value.positive?
|
|
301
|
+
@config[name] = value
|
|
302
|
+
rescue ArgumentError, TypeError
|
|
303
|
+
raise ServerError, "#{name} must be a number"
|
|
304
|
+
end
|
|
305
|
+
end
|
|
306
|
+
|
|
307
|
+
def daemonize
|
|
308
|
+
return unless @config[:daemonize]
|
|
309
|
+
|
|
310
|
+
Process.daemon(true, true)
|
|
311
|
+
$stdout.reopen(File.join(@config[:log_dir], "rubydb.out"), "a")
|
|
312
|
+
$stderr.reopen(File.join(@config[:log_dir], "rubydb.err"), "a")
|
|
313
|
+
end
|
|
314
|
+
|
|
315
|
+
def write_pid_file
|
|
316
|
+
File.write(@config[:pid_file], Process.pid.to_s)
|
|
317
|
+
end
|
|
318
|
+
|
|
319
|
+
def remove_pid_file
|
|
320
|
+
File.delete(@config[:pid_file]) if File.exist?(@config[:pid_file])
|
|
321
|
+
end
|
|
322
|
+
|
|
323
|
+
def start_stats_thread
|
|
324
|
+
Thread.new do
|
|
325
|
+
while @running
|
|
326
|
+
sleep(10)
|
|
327
|
+
update_stats
|
|
328
|
+
end
|
|
329
|
+
end
|
|
330
|
+
end
|
|
331
|
+
|
|
332
|
+
def update_stats
|
|
333
|
+
@lock.synchronize do
|
|
334
|
+
@stats[:connections_active] = @connection_pool&.active_count || 0
|
|
335
|
+
@stats[:connections_total] = @connection_pool&.total_connections || 0
|
|
336
|
+
@stats[:requests_processed] = @request_handler&.stats&.dig(:requests_processed) || 0
|
|
337
|
+
end
|
|
338
|
+
end
|
|
339
|
+
|
|
340
|
+
def get_memory_usage
|
|
341
|
+
# Get memory usage in MB
|
|
342
|
+
if File.exist?("/proc/self/status")
|
|
343
|
+
File.read("/proc/self/status").each_line do |line|
|
|
344
|
+
if line.start_with?("VmRSS:")
|
|
345
|
+
return line.split[1].to_i / 1024
|
|
346
|
+
end
|
|
347
|
+
end
|
|
348
|
+
end
|
|
349
|
+
|
|
350
|
+
# Fallback - run ps command
|
|
351
|
+
begin
|
|
352
|
+
output = `ps -o rss= -p #{Process.pid}`
|
|
353
|
+
return output.strip.to_i / 1024 if output && !output.empty?
|
|
354
|
+
rescue
|
|
355
|
+
# Ignore
|
|
356
|
+
end
|
|
357
|
+
|
|
358
|
+
0
|
|
359
|
+
rescue
|
|
360
|
+
0
|
|
361
|
+
end
|
|
362
|
+
end
|
|
363
|
+
end
|
|
364
|
+
end
|