Sdílet prostřednictvím

klauzule ADD CONSTRAINT

Platí pro:ano (zaškrtnuto) Databricks SQL ano (zaškrtnuto) Databricks Runtime

Přidá informační primární klíč, informační cizí klíč nebo vynucenou kontrolní podmínku do existující tabulky Delta Lake, materializovaného zobrazení nebo streamované tabulky.

Syntaxe

ADD [check_constraint | key_constraint ]

check_constraint
    CONSTRAINT name CHECK ( condition ) [ ENFORCED ]

key_constraint
    { [ CONSTRAINT name ]
      {
        PRIMARY KEY ( key_column [ TIMESERIES ] [, ...] ) [ constraint_option [...] ] |
        { FOREIGN KEY (foreign_key_column [, ...] )
          REFERENCES parent_relation [ ( parent_column [, ...] ] )
          [ constraint_option | foreign_key_option ] [...]
      }
    }

constraint_option
    { NOT ENFORCED |
      DEFERRABLE |
      INITIALLY DEFERRED |
      { NORELY | RELY } }

foreign_key_option
    { MATCH FULL |
      ON UPDATE NO ACTION |
      ON DELETE NO ACTION }

Kvůli kompatibilitě s nestandardními dialekty SQL můžete místo ENABLE NOVALIDATENOT ENFORCED DEFERRABLE INITIALLY DEFERRED.

Parametry

  • check_constraint

    Definuje omezení kontroly pro relaci.

    • CONSTRAINT Jméno

      Určuje název omezení. Název musí být v rámci relace jedinečný.

    • CHECK ( podmínka)

      Relace DEFAULT COLLATION musí být UTF8_BINARY v době přidání omezení.

      condition musí být deterministický výraz vracející BOOLEAN.

      condition mohou se skládat z literálů, identifikátorů sloupců v rámci relace a deterministické předdefinované funkce nebo operátory SQL s výjimkou:

      Také condition nesmí obsahovat žádný poddotaz.

      Aby bylo omezení CHECK v Azure Databricks splněno, je třeba, aby se vyhodnotilo jako true.

      Delta Lake ověřuje platnost omezení kontroly vůči novým i existujícím datům. Pokud některý existující řádek porušuje omezení, dojde k vyvolání chyby.

  • key_constraint

    Důležité

    Tato funkce je ve verzi Public Preview.

    Platí pro:označeno jako ano Databricks SQL označeno jako ano Databricks Runtime 11.3 LTS a vyšší

    Definuje omezení informačního primárního klíče nebo informačního cizího klíče pro relaci. Informační klíčová omezení se nevynucují, ale můžou zlepšit výkon díky podpoře optimalizací dotazů.

    • CONSTRAINT Jméno

      Volitelně můžete určit název omezení. Název musí být v rámci schématu jedinečný. Pokud není zadaný žádný název, Azure Databricks ho vygeneruje.

    • PRIMARY KEY ( key_column [ TIMESERIES ] [, ...] ) [ constraint_option [...] ]

      Platí pro:zaškrtnuto ano Pouze katalog Unity

      Přidá omezení primárního klíče do relace. Relace může mít maximálně jeden primární klíč.

      Omezení primárních klíčů nejsou podporována u relací v katalogu hive_metastore.

    • key_column

      Sloupec vztahu předmětu definovaného jako NOT NULL. Názvy sloupců se nesmí opakovat.

    • TIMESERIES

      Platí pro:označeno zaškrtnutím Databricks SQL označeno zaškrtnutím Databricks Runtime 13.3 LTS a vyšší

      Volitelně označí komponentu sloupce primárního klíče jako reprezentaci časových intervalů.

    • FOREIGN KEY ( foreign_key_column [, ...] ) REFERENCES parent_relation [ ( parent_column [, ...] ) ] foreign_key_option

      Platí pro:zaškrtnuto ano Pouze katalog Unity

      Přidá do vztahu omezení cizího klíče (referenční integrita).

      Omezení cizího hive_metastore klíče nejsou podporována pro vztahy v katalogu.

      • cizí_klíčový_sloupec

        Sloupec vztahu subjektu. Názvy sloupců se nesmí opakovat. Datový typ každého sloupce musí odpovídat typu odpovídajícího parent_column. Počet sloupců musí odpovídat počtu parent_columns. Dva cizí klíče nemohou sdílet stejnou sadu sloupců cizího klíče.

      • parent_relation

        Určuje vztah, na který cizí klíč odkazuje. Relace musí mít definované PRIMARY KEY omezení a musíte mít SELECT oprávnění k relaci.

      • parent_column

        Sloupec v mateřské relaci, který je součástí jejího primárního klíče. Všechny sloupce primárního klíče nadřazené relace musí být uvedeny.

        Pokud nadřazené sloupce nejsou uvedené, předpokládá se, že jsou určené podle pořadí uvedeného v definici PRIMARY KEY.

      Omezení cizího klíče, která se liší pouze v permutaci sloupců cizího klíče, nejsou povolena.

    • constraint_option

      Vypíše vlastnosti omezení. Všechny vlastnosti jsou volitelné, ale implicitní ve výchozím nastavení. Každá vlastnost může být maximálně zadána jednou.

      • NOT ENFORCED

        Azure Databricks neprosadí žádnou akci k vynucování pro existující nebo nové řádky.

      • DEFERRABLE

        Vynucení omezení je možné odložit.

      • INITIALLY DEFERRED

        Vynucení omezení je odloženo.

      • NORELY nebo RELY

        Platí pro:zaškrtnuto ano Databricks SQL zaškrtnuto ano Databricks Runtime 14.2 a vyšší pro PRIMARY KEY omezení

        platí pro:(zaškrtněte políčko Ano) Databricks SQL (zaškrtněte políčko Ano) Databricks Runtime 15.4 a vyšší pro omezení FOREIGN KEY.

        Pokud RELY, azure Databricks může omezení zneužít k přepsání dotazů. Je zodpovědností uživatele, aby bylo zajištěno, že omezení bude splněno. Spoléhat se na omezení, které není splněno, může vést k nesprávným výsledkům dotazu.

        Výchozí hodnota je NORELY.

    • foreign_key_option

      Zobrazí seznam vlastností specifických pro omezení cizího klíče. Všechny vlastnosti jsou volitelné, ale implicitní ve výchozím nastavení. Každá vlastnost může být maximálně zadána jednou.

      • MATCH FULL

        Aby bylo omezení považováno za pravdivé, musí být všechny hodnoty sloupců NOT NULL.

      • ON UPDATE NO ACTION

        Pokud je nadřazená PRIMARY KEY aktualizovaná, služba Azure Databricks neprovádí žádnou akci, která by omezila aktualizaci nebo aktualizovala cizí klíč.

      • ON DELETE NO ACTION

        Pokud se nadřazený řádek odstraní, Azure Databricks neuskutečí žádnou akci k omezení akce, aktualizaci cizího klíče nebo odstranění závislého řádku.

Důležité

Azure Databricks nevynucuje omezení primárního klíče ani cizího klíče. Před přidáním primárního nebo cizího klíče potvrďte omezení klíče. Váš proces ingestování může poskytnout takové záruky nebo můžete spouštět kontroly vašich dat.

Příklady

-- Add a primary key
> CREATE TABLE persons(first_name STRING NOT NULL, last_name STRING NOT NULL, nickname STRING);
> ALTER TABLE persons ADD CONSTRAINT persons_pk PRIMARY KEY(first_name, last_name);

-- Add a foreign key which Databricks does not enforce, but can rely upon.
> CREATE TABLE pets(name STRING, owner_first_name STRING, owner_last_name STRING);
> ALTER TABLE pets ADD CONSTRAINT pets_persons_fk
    FOREIGN KEY(owner_first_name, owner_last_name) REFERENCES persons
    NOT ENFORCED RELY;

-- Add a check contraint
> ALTER TABLE pets ADD CONSTRAINT pets_name_not_cute_chk CHECK (length(name) < 20);