Postgres pro standard de documentare 9

CREATE EXTENSION încarcă o nouă extensie în baza de date curentă. O extensie cu acest nume nu ar trebui să fie deja încărcată.

Descărcarea unei extensii este în esență o chestiune de pornire a scriptului de expansiune. Acest script creează, de obicei, noi obiecte SQL, cum ar fi funcții, tipuri de date, operatori și metode de suport index. CREATE EXTENSION înregistrează în plus identificatorii tuturor obiectelor adăugate, astfel încât acestea să poată fi eliminate ulterior prin rularea comenzii DROP EXTENSION.

Pentru a descărca o extensie, aveți nevoie de aceleași drepturi care sunt necesare pentru a crea obiectele sale constituente. Pentru cele mai multe extensii, aceasta înseamnă că aveți nevoie de drepturile proprietarului bazei de date sau superuserului. Utilizatorul care execută CREATE EXTENSION. devine proprietarul extensiei în sine (acest lucru este necesar pentru verificările de acces ulterioare), precum și proprietarul tuturor obiectelor create de scriptul de extensie.

Nu considerați o eroare dacă există deja o extensie cu acest nume. În acest caz, va fi emisă o notă. Rețineți că nu există nicio garanție că extensia existentă este oarecum legată de cea care ar putea fi creată din scriptul specificat. imya_rasshireniya

Numele extensiei de instalat. Postgres Pro va crea o extensie utilizând instrucțiunile din fișierul .control SHAREDIR / extension / extension_name. nume_schemă

Numele schemei în care vor fi instalate obiectele de extensie (se presupune că extensia vă permite să gestionați plasarea obiectelor dvs.). Această schemă ar trebui să existe deja. Dacă numele nu este specificat și, de asemenea, nu este specificat în fișierul de control al extensiei, schema curentă este utilizată pentru a crea obiectele.

Dacă este specificat un parametru de schemă în fișierul de control al extensiei. Schema specificată nu poate fi înlocuită de clauza SCHEMA. În mod normal, când se specifică clauza SCHEMA, apare o eroare dacă această schemă este în conflict cu parametrul schemei acestei extensii. Cu toate acestea, dacă este specificată clauza CASCADE. În cazul unui conflict, numele schemei este ignorat. Schema_name specificată va fi utilizată pentru a seta toate extensiile necesare, în fișierele de control ale cărora nu este specificată nicio schemă.

Rețineți că extinderea în sine nu este considerată ca aparținând vreunei scheme; numele extensiilor nu sunt completate de schemă și, prin urmare, trebuie să fie unice în întreaga bază de date. Cu toate acestea, obiectele aparținând extensiilor se pot referi la scheme. versiune

Versiunea extensiei de instalat. Acesta poate fi scris sub forma unui identificator sau a unei valori de șir. Implicit, versiunea este citită din fișierul de control al extensiei. versiunea veche

Clauza FROM a versiunii vechi poate fi adăugată dacă și numai dacă extensia care urmează să fie instalată înlocuiește modulul "stil vechi". care este doar un set de obiecte care nu sunt ambalate într-o extensie. Cu această specificație, CREATE EXTENSION începe un script alternativ de instalare care colectează toate obiectele existente într-o extensie, în loc să creeze altele noi. Rețineți că SCHEMA determină schema care conține aceste obiecte existente.

Instalați automat toate extensiile de care depinde aceasta, dacă acestea nu sunt deja instalate. Dependentele lor sunt instalate recursiv în mod automat. Oferta SCHEMA. dacă este setat, se aplică tuturor extensiilor instalate în acest fel. Alți parametri de operator nu se aplică extensiilor instalate automat; în special, versiunile lor sunt întotdeauna selectate în mod implicit.

Înainte de a putea executa CREATE EXTENSION și încărca extensia în baza de date, trebuie să instalați corect fișierele de extensie însoțitoare. Informații despre instalarea extensiilor furnizate împreună cu Postgres Pro. pot fi găsite sub linkul Module suplimentare furnizate.

Extensiile disponibile pentru instalare în acest moment pot fi găsite în vizualizarea de sistem pg_available_extensions sau pg_available_extension_versions.

Pentru informații pentru dezvoltatorii de extindere, consultați secțiunea 37.15.

Instalarea extensiei hstore în baza de date curentă:

Conversia modulului hstore instalat la versiunea 9.1 într-o extensie:

Aveți grijă - aici trebuie să specificați schema în care au fost instalate anterior obiectele hstore existente.

compatibilitate

CREATE EXTENSION este o extensie a Postgres Pro.