Zum Inhalt
HALOWERK

Datenvertragswerk

iceberg v2 delete scope

Check a proposed Iceberg-V2 file-to-delete-file scan scope plan before a data reader applies deletes to supplied snapshot metadata. Pinned bounded V2 FILE-scope profile only; no row matching,file access or deletion. A schema-valid unknown costs the same fixed price. Invalid input requires nativeHTTP400 before settlement. A schema-valid unknown is a successful result at the same fixed price; requests are capped at16384UTF8bytes and data replies at32768UTF8bytes; invalid input must raise.

POST https://datenvertrag.halowerk.com/v1/iceberg-v2-delete-scope

Eingaben

Felder des veröffentlichten Eingabeschemas
FeldTypPflichtBeschreibung
format_versionSiehe SchemaJa
partition_specsarrayJa
data_filesarrayJa
delete_filesarrayJa
proposed_pairsarrayJa
Vollständiges Eingabeschema anzeigen
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "format_version": {
      "const": 2
    },
    "partition_specs": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "integer",
            "minimum": 0,
            "maximum": 65535
          },
          "field_count": {
            "type": "integer",
            "minimum": 0,
            "maximum": 4
          }
        },
        "required": [
          "id",
          "field_count"
        ]
      },
      "minItems": 0,
      "maxItems": 4
    },
    "data_files": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{1,16}$"
          },
          "status": {
            "enum": [
              "added",
              "existing",
              "deleted"
            ]
          },
          "data_sequence": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1000000000
              },
              {
                "type": "null"
              }
            ]
          },
          "manifest_sequence": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1000000000
              },
              {
                "type": "null"
              }
            ]
          },
          "spec_id": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 65535
              },
              {
                "type": "null"
              }
            ]
          },
          "partition": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_-]{1,16}$"
                    },
                    {
                      "type": "integer",
                      "minimum": -1000000000,
                      "maximum": 1000000000
                    },
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "minItems": 0,
                "maxItems": 4
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "status",
          "data_sequence",
          "manifest_sequence",
          "spec_id",
          "partition"
        ]
      },
      "minItems": 1,
      "maxItems": 8
    },
    "delete_files": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{1,16}$"
          },
          "status": {
            "enum": [
              "added",
              "existing",
              "deleted"
            ]
          },
          "data_sequence": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1000000000
              },
              {
                "type": "null"
              }
            ]
          },
          "manifest_sequence": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1000000000
              },
              {
                "type": "null"
              }
            ]
          },
          "spec_id": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 65535
              },
              {
                "type": "null"
              }
            ]
          },
          "partition": {
            "anyOf": [
              {
                "type": "array",
                "items": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^[A-Za-z0-9_-]{1,16}$"
                    },
                    {
                      "type": "integer",
                      "minimum": -1000000000,
                      "maximum": 1000000000
                    },
                    {
                      "type": "boolean"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "minItems": 0,
                "maxItems": 4
              },
              {
                "type": "null"
              }
            ]
          },
          "kind": {
            "enum": [
              "position",
              "equality"
            ]
          }
        },
        "required": [
          "id",
          "status",
          "data_sequence",
          "manifest_sequence",
          "spec_id",
          "partition",
          "kind"
        ]
      },
      "minItems": 0,
      "maxItems": 8
    },
    "proposed_pairs": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "data": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{1,16}$"
          },
          "delete": {
            "type": "string",
            "pattern": "^[A-Za-z0-9_-]{1,16}$"
          }
        },
        "required": [
          "data",
          "delete"
        ]
      },
      "minItems": 0,
      "maxItems": 64
    }
  },
  "required": [
    "format_version",
    "partition_specs",
    "data_files",
    "delete_files",
    "proposed_pairs"
  ]
}

Originalschema öffnen

Veröffentlichtes Eingabebeispiel

{
  "format_version": 2,
  "partition_specs": [
    {
      "id": 0,
      "field_count": 0
    },
    {
      "id": 1,
      "field_count": 1
    },
    {
      "id": 2,
      "field_count": 1
    }
  ],
  "data_files": [
    {
      "id": "D",
      "status": "existing",
      "data_sequence": 1,
      "manifest_sequence": 10,
      "spec_id": 1,
      "partition": [
        "p"
      ]
    }
  ],
  "delete_files": [
    {
      "id": "X",
      "status": "existing",
      "data_sequence": 2,
      "manifest_sequence": 10,
      "spec_id": 1,
      "partition": [
        "p"
      ],
      "kind": "equality"
    }
  ],
  "proposed_pairs": [
    {
      "data": "D",
      "delete": "X"
    }
  ]
}

Ergebnis & Dokumentation

Maschinenlesbare Dokumentation dieses Hubs

Quelle dieser Seite: der veröffentlichte HALOWERK-Katalog. Stand: 2026-11-07, 02:42 UTC.

Weitere Endpunkte dieses Hubs

Alle Endpunkte dieses Hubs →