[codex] Support configurable database node counts

.github/workflows/matrix-slow.yml

@@ -0,0 +1,37 @@
+name: Build Matrix (Slow Tests)
+
+on:
+  workflow_call:
+    outputs:
+      matrix:
+        description: "Generates the slow test build matrix"
+        value: ${{ jobs.set-matrix-slow.outputs.matrix }}
+
+jobs:
+  set-matrix-slow:
+    runs-on: "ubuntu-24.04"
+    permissions:
+      contents: read
+    steps:
+      - name: Check out Repository
+        id: check-out-repository
+        uses: actions/checkout@v6
+
+      - name: Set up Python & Poetry Environment
+        id: set-up-python-and-poetry-environment
+        uses: exasol/python-toolbox/.github/actions/python-environment@v7
+        with:
+          python-version: "3.10"
+          poetry-version: "2.3.0"
+
+      - name: Generate Matrix
+        id: generate-matrix
+        run: poetry run -- nox -s matrix:slow
+
+      - name: Set Matrix
+        id: set-matrix
+        run: |
+          echo "matrix=$(poetry run -- nox -s matrix:slow)" >> $GITHUB_OUTPUT
+
+    outputs:
+      matrix: ${{ steps.set-matrix.outputs.matrix }}

.github/workflows/slow-checks.yml

@@ -4,12 +4,22 @@ on:
   workflow_call:
 
 jobs:
+  build-slow-matrix:
+    name: Build Slow Matrix
+    uses: ./.github/workflows/matrix-slow.yml
+    permissions:
+      contents: read
 
   run-integration-tests:
-    name: Run Integration Tests
+    name: Run Integration Tests (${{ matrix.test-name }})
+    needs:
+      - build-slow-matrix
     runs-on: "ubuntu-24.04"
     permissions:
       contents: read
+    strategy:
+      fail-fast: false
+      matrix: ${{ fromJSON(needs.build-slow-matrix.outputs.matrix) }}
     env:
       GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
     steps:
@@ -26,18 +36,21 @@ jobs:
 
       - name: Run Integration Tests
         id: run-integration-tests
-        run: poetry run -- nox -s test:integration -- --coverage
+        run: |
+          poetry run coverage run \
+            --rcfile=pyproject.toml \
+            -m pytest -v "${{ matrix.test-path }}"
         env:
           SAAS_HOST: ${{ secrets.INTEGRATION_TEAM_SAAS_STAGING_HOST }}
           SAAS_ACCOUNT_ID: ${{ secrets.INTEGRATION_TEAM_SAAS_STAGING_ACCOUNT_ID }}
           SAAS_PAT: ${{ secrets.INTEGRATION_TEAM_SAAS_STAGING_PAT }}
           PROJECT_SHORT_TAG: SAPIPY
-          PYTEST_ADDOPTS: '-o log_cli=true -o log_cli_level=INFO'
+          PYTEST_ADDOPTS: '-o log_cli=true -o log_cli_level=DEBUG'
 
       - name: Upload Artifacts
         id: upload-artifacts
         uses: actions/upload-artifact@v7
         with:
-          name: coverage-python3.10-slow
+          name: coverage-python3.10-slow-${{ matrix.test-name }}
           path: .coverage
           include-hidden-files: true

doc/changes/unreleased.md

@@ -15,6 +15,8 @@ Besides there are many formal and syntactic changes
 
 ## Summary
 
+* #147: Added `num_nodes` support to the handwritten database creation helpers.
+
 ## Refactorings
 
 * #160: Updated PTB to version 7.0.0

exasol/saas/client/_api_access/__init__.py

@@ -0,0 +1,33 @@
+from exasol.saas.client._api_access.access import OpenApiAccess
+from exasol.saas.client._api_access.common import (
+    _log_api_output,
+    create_saas_client,
+    ensure_type,
+    interval_retry,
+    timestamp_name,
+)
+from exasol.saas.client._api_access.database_ops import (
+    get_connection_params,
+    get_database_id,
+)
+from exasol.saas.client._api_access.errors import (
+    DatabaseDeleteError,
+    DatabaseDeleteTimeout,
+    DatabaseStartupFailure,
+    OpenApiError,
+)
+
+__all__ = [
+    "DatabaseDeleteError",
+    "DatabaseDeleteTimeout",
+    "DatabaseStartupFailure",
+    "OpenApiAccess",
+    "OpenApiError",
+    "_log_api_output",
+    "create_saas_client",
+    "ensure_type",
+    "get_connection_params",
+    "get_database_id",
+    "interval_retry",
+    "timestamp_name",
+]