You are on page 1of 9

Bsquedadedocumentacin: Search Buscar Tamaodeltexto:normal/grande InicioDocumentacinManualesPostgreSQL9.3 Estapginaenotrasversiones:8.4/9.0/9.1/9.2/9.3|Versionesdedesarrollo:desarrollo|Versionescompatibles:7,1/7,2/7,3/7,4/8,0/8,1/8,2 /8,3 PostgreSQL9.3.

0Documentacin Anterior Hasta Prximo

ALTERTABLE
Nombre
ALTERTABLEcambiarladefinicindeunatabla

Sinopsis
A L T E RT A B L E[ I FE X I S T S ][ O N L Y ]n o m b r e[ * ] m e d i d a s[ ,. . .] A L T E RT A B L E[ I FE X I S T S ][ O N L Y ]n o m b r e[ * ] R E N A M E[ C O L U M N A ]c o l u m n _ n a m eAn e w _ c o l u m n _ n a m e A L T E RT A B L E[ I FE X I S T S ][ O N L Y ]n o m b r e[ * ] C A M B I A RE LN O M B R ED ER E S T R I C C I Nc o n s t r a i n t _ n a m eAn e w _ c o n s t r a i n t _ n a m e A L T E RT A B L E[ I FE X I S T S ]N o m b r e R e n o m b r a rp a r an o m b r e _ n u e v o A L T E RT A B L E[ I FE X I S T S ]N o m b r e S E TS C H E M An e w _ s c h e m a d o n d el aa c c i ne su n od e : A D D[ C O L U M N A ]c o l u m n _ n a m e d a t a _ t y p e[ C O L L A T Ec o t e j o][c o l u m n _ c o n s t r a i n t[ . . .] ] D R O P[ C O L U M N A ][ I FE X I S T S ]c o l u m n _ n a m e[ R E S T R I C T|C A S C A D E ] A L T E R[ C O L U M N A ]c o l u m n _ n a m e[ S E TD A T A ]T I P Od a t a _ t y p e[ C O L L A T Ec o t e j o][ U s od ee x p r e s i n] A L T E R[ C O L U M N A ]c o l u m n _ n a m eS E TD E F A U L Te x p r e s i n A L T E R[ C O L U M N A ]c o l u m n _ n a m eD R O PD E F A U L T A L T E R[ C O L U M N A ]c o l u m n _ n a m e{ S E T|D R O P }N O TN U L L A L T E R[ C O L U M N A ]c o l u m n _ n a m eS E TS T A T I S T I C Se n t e r o A L T E R[ C O L U M N A ]c o l u m n _ n a m eS E T(a t t r i b u t e _ o p t i o n=v a l o r[ ,. . . ] ) A L T E R[ C O L U M N A ]c o l u m n _ n a m eR E S E T(a t t r i b u t e _ o p t i o n[ ,. . . ] ) A L T E R[ C O L U M N A ]c o l u m n _ n a m eA L M A C E N A M I E N T O{ S E TP L A I N|E X T E R I O R|A m p l i a d a|P R I N C I P A L } A A D I Rr e s t r i c c i n _ t a b l a[ N OV L I D O ] A A D I Rt a b l e _ c o n s t r a i n t _ u s i n g _ i n d e x V A L I D A RR E S T R I C C I Nc o n s t r a i n t _ n a m e q u i t a rl ar e s t r i c c i n[ I FE X I S T S ] c o n s t r a i n t _ n a m e[ R E S T R I N G I R|C A S C A D E ] D I S A B L ET R I G G E R[t r i g g e r _ n a m e|A L L|U S U A R I O ] H A B I L I T A RD I S P A R O[t r i g g e r _ n a m e|A L L|U S U A R I O ] A C T I V A RR E P L I C AT R I G G E Rt r i g g e r _ n a m e h a b i l i t a rs i e m p r eT R I G G E Rt r i g g e r _ n a m e D E S A C T I V A RL AR E G L Ar e w r i t e _ r u l e _ n a m e H a b i l i t a rr e g l ar e w r i t e _ r u l e _ n a m e A C T I V A RR E P L I C AR E G L Ar e w r i t e _ r u l e _ n a m e h a b i l i t a rs i e m p r eR E G L Ar e w r i t e _ r u l e _ n a m e c l s t e re ni n d e x _ n a m e J U E G OS I NG R U P O S E TC O NO I D S J U E G OS I NO I D S S E T(p a r m e t r o _ a l m a c e n a m i e n t o=v a l o r[ ,. . . ] ) R E S E T(p a r m e t r o _ a l m a c e n a m i e n t o[ ,. . . ] ) I N H E R I Tt a b l a _ p a d r e N OI N H E R I Tt a b l a _ p a d r e D Et y p e _ n a m e N OD E P R O P I E T A R I OD En e w _ o w n e r S E TT A B L E S P A C En e w _ t a b l e s p a c e yt a b l e _ c o n s t r a i n t _ u s i n g _ i n d e xe s : [ R E S T R I C C I Nc o n s t r a i n t _ n a m e] { U N I Q U E|P R I M A R YK E Y }U S O N D I C Ei n d e x _ n a m e [ D E F E R R A B L E|N OD E F E R R A B L E ][ A P L A Z A D O SI N I C I A L M E N T E|I N I C I A L M E N T EI N M E D I A T A ]

Descripcin
A L T E RT A B L E cambialadefinicindeunatablaexistente.Hayvariossubformularios: A A D I RC O L U M N A

Estaformaagregaunanuevacolumnaalatabla,usandolamismasintaxisqueCREATETABLE.
Q u i t a rl ac o l u m n a[ I FE X I S T S ]

Estaformadejacaerunacolumnadeunatabla.Losndicesylasrestriccionesdetablaqueinvolucranlacolumnaserdadodebaja automticamente.UstedtendrquedecirC A S C A D E sialgofueradelatabladependedelacolumna,porejemplo,referenciasopuntosdevistade clavesexternas.SiS IE X I S T E seespecificaylacolumnanoexiste,seproduceningnerror.Enestecaso,seemiteunavisoensulugar.


S IE X I S T E

Nolanceunerrorsilatablanoexiste.Unavisoseemiteenestecaso.
S E TD A T AT Y P E

Estaformacambiaeltipodeunacolumnadeunatabla.ndicesysimplesrestriccionesdetablaqueinvolucranlacolumnaseconvertirn automticamenteautilizarelnuevotipodecolumnaporotroanlisisdelaexpresinproporcionadaoriginalmente.LaopcinC O L L A T E clusula especificaunaintercalacinparalacolumnanueva,siseomite,lacolacineselvalorpredeterminadoparaelnuevotipodecolumna.Elsistema opcionalU S O clusulaespecificacmocalcularelnuevovalordelacolumnadelavieja,siseomite,laconversinpordefectoeselmismoque unamisinconversindeltipodedatosantiguaalanueva.AU T I L I Z A R clusuladebeserproporcionadasinohayunaconversinimplcitao cesindelaantiguaalanuevatipo.


S E T /D R O PD E F A U L T

Estasformasdeestableceroeliminarelvalorpredeterminadodeunacolumna.LosvalorespordefectosloseaplicanenlaposteriorI N S E R T o A C T U A L I Z A C I N comandosnocausanfilasqueyaestnenlamesaparacambiar.
S E T /D R O PN O TN U L L

Estasformascambiansiunacolumnaestmarcadaparapermitirvaloresnulosorechazarlosvaloresnulos.SlosepuedeutilizarS E TN O TN U L L cuandolacolumnanocontienevaloresnulos.
S E TS T A T I S T I C S

EsteformularioestableceelobjetivoderecopilacindeestadsticasporcolumnaparaposterioresANALIZARoperaciones.Elobjetivosepuede ajustarenelrangode0a10000alternativamente,estableceren1paravolverausarelobjetivoestadsticaspordefectodelsistema( default_statistics_target).ParaobtenermsinformacinsobreelusodelaestadsticadelPostgreSQLplaneadordeconsultas,consultelaSeccin 14.2.


S E T(a t t r i b u t e _ o p t i o n=v a l o r[ ,. . . ] ) R E S E T(a t t r i b u t e _ o p t i o n[ ,. . . ] )

Esteformularioestableceorestablecelasopcionesperatributos.Enlaactualidad,lasopcionesdeperatributosdefinidosslosonn _ d i s t i n c t y n _ d i s t i n c t _ i n h e r i t e d ,quereemplazaelnmerodeclaralosvaloresdelasestimacionesrealizadasporposterioresANALIZARoperaciones. n _ d i s t i n c t afectaalasestadsticasdelapropiatabla,mientrasn _ d i s t i n c t _ i n h e r i t e d afectaalasestadsticasrecopiladasporlamesamssus hijoslaherencia.Cuandoseestableceenunvalorpositivo,A N A L I Z A R asumirquelacolumnacontieneexactamenteelnmeroespecificadode valoresnoNULLdistintos.Cuandoseestableceenunvalornegativo,quedebesermayoroiguala1,A N A L I Z A R ,seasumirqueelnmerode valoresnoNULLdistintosdelacolumnaeslinealeneltamaodelatabla,elnmeroexactosecalculamultiplicandoelestimadotamaodela tablaporelvalorabsolutodelnmerodado.Porejemplo,unvalorde1implicaquetodoslosvaloresdelacolumnasondistintos,mientrasque unvalorde0,5implicaquecadavaloraparecedosvecesenlamedia.Estopuedesertilcuandoeltamaodeloscambiosdelatablaenel tiempo,yaquelamultiplicacinporelnmerodefilasdelatablanoserealizahastaqueeltiempodeplanificacinconsulta.Especifiqueunvalor de0paravolveraestimarelnmerodevaloresdistintosquenormalmente.Paraobtenermsinformacinsobreelusodelaestadsticadel PostgreSQLplaneadordeconsultas,consultelaSeccin14.2.
S E TD EA L M A C E N A M I E N T O

Estaformaestableceelmododealmacenamientoparaunacolumna.Estocontrolasiestacolumnasemantieneenlneaoenunasecundaria TOASTmesa,ysilosdatosdebensercomprimidosono.N O R M A L debeserutilizadoparalosvaloresdelongitudfijacomon m e r oe n t e r o yes inline,nocomprimido.P R I N C I P A L esparaenlnea,datosdecompresin.E X T E R N A es,datosnocomprimidosexternosyE X T E N D E D esparadatos externoscomprimidos.E X T E N D E D eselvalorpordefectoparalamayoradelostiposdedatosqueadmitennoP L A I N almacenamiento.Elusode E X T E R N O haroperacionesdesubcadenaengrant e x t o yb y t e a valoresdecorrermsrpido,alapenadeunmayorespaciodealmacenamiento.

TengaencuentaqueS E TA L M A C E N A M I E N T O smismo,nocambianadaenlatabla,sloestablecelaestrategiaaseguirenlasfuturas actualizacionesdelatabla.VerlaSeccin58.2paramsinformacin.


A A D I Rr e s t r i c c i n _ t a b l a[ N OV L I D O ]

EstaformaagregaunanuevarestriccinaunatablautilizandolamismasintaxisqueCREATETABLE,ademsdelaopcinN OV L I D O ,que actualmenteslopermitaclaveexternaylasrestriccionesCHECK.SilarestriccinsemarcaN OV L I D O ,lacomprobacininicialpotencialmente largaparaverificarquetodaslasfilasdelatablasatisfacenlarestriccinseomite.Larestriccinseguirsiendoaplicadacontrainsercioneso actualizacionesposteriores(esdecir,novanamenosquehayaunafilacoincidenteenlatabladereferencia,enelcasodeclavesforneas,yse fallaramenosquelanuevafilacoincideconlacomprobacinespecificadalimitaciones).Perolabasededatosnosupondrquelarestriccines vlidaparatodaslasfilasdelatabla,hastaquesevalidamedianteelR E S T R I C C I NV A L I D A R opcin.


A A D I Rt a b l e _ c o n s t r a i n t _ u s i n g _ i n d e x

EstaformaagregaunnuevoP R I M A R YK E Y oU N I Q U E restriccinaunatablabasadaenunndicenicoexistente.Todaslascolumnasdelndice sernincluidosenlarestriccin. Elndicenopuedetenercolumnasdeexpresinniserunndiceparcial.Adems,debeserunndiceBtreeconordenpredeterminadopedido. EstasrestriccionesaseguranqueelndiceesequivalentealaqueseconstruiraenunhabitualA D DP R I M A R YK E Y oU N I Q U EA A D I R comandos. SiP R I M A R YK E Y seespecifica,ylascolumnasdelndicenoestyamarcadaN O TN U L L ,estecomandointentarhacerA L T E RC O L U M NN OS E T N U L L encontradecadacolumna.Esorequiereunescaneocompletodetablaparacomprobarlacolumna(s)nocontienenvaloresnulos.Entodos losdemscasos,setratadeunaoperacinrpida. Siunnombrederestriccinseproporcionaacontinuacin,elndiceserrenombradoparacoincidirconelnombredelarestriccin.Delo contrariolarestriccinserelmismonombrequeelndice. Despusdeejecutarestecomando,elndicees"propiedad"delarestriccin,delamismamaneraquesielndicehabasidoconstruidoporun habitualA D DP R I M A R YK E Y oU N I Q U EA A D I R comandos.Enparticular,descartandolarestriccinharqueelndicededesaparecertambin. Nota:Adicindeunarestriccinconunndiceexistentepuedesertilensituacionesenlasqueunanuevarestriccintienequeser aadidosinbloquearactualizacionesdelatabladurantemuchotiempo.Paraello,creeelndicedeusodeC R E A T EI N D E X C O N C O M I T A N T E y,acontinuacin,instalarlacomounarestriccinoficialconestasintaxis.Veaelsiguienteejemplo.
V A L I D A RR E S T R I C C I N

EstaformavalidaunaclaveexternaorestriccindecomprobacindequesehacreadopreviamentecomoN OV L I D O ,medianteelescaneodela tablaparaasegurarsedequenohayfilasparalasquelarestriccinnosecumple.Nopasanadasilarestriccinqueyaestmarcadovlido. Lavalidacinpuedeserunlargoprocesoenlasmesasmsgrandesyenlaactualidadrequieredeuna c c e s oe x c l u s i v o bloqueo.Elvalordela separacindelavalidacindelacreacininicialesquesepuedeaplazarlavalidacindelapocademenorafluencia,opuedeserusadoparadar mstiempoparacorregirloserrorespreexistentesyprevenirnuevoserrores.


Q u i t a rl ar e s t r i c c i n[ I FE X I S T S ]

Estaformareducelarestriccinespecificadaenunamesa.SiS IE X I S T E seespecificaylarestriccinnoexiste,seproduceningnerror.Eneste caso,seemiteunavisoensulugar.


D E S A C T I V A R /A C T I V A R[ R E P L I C A|A l w a y s ]A c t i v a r

Estasformasconfigurareldisparodegatillo(s)quepertenecealatabla.Undisparadordeshabilitadotodavaseconocealsistema,peronose ejecutacuandoseproduceelhechocausante.Paraundisparadordiferido,elestadodehabilitacinsecompruebacuandoseproduceelevento,no cuandolafuncindedisparoseejecutarealmente.Sepuedeactivarodesactivarunsolodisparoespecificadoporelnombre,otodolodisparaen lamesa,oelnicousuarioactiva(estaopcinexcluyeinternamenterestriccingeneradadesencadenatalescomolosqueseutilizanparaaplicar restriccionesdeclavesforneasosingularidadprorrogableylasrestriccionesdeexclusin).Cmohabilitarodeshabilitarlarestriccingenerada internamenteactivarequiereprivilegiosdesuperusuario,sinoquedebehacerseconcautela,yaque,porsupuesto,laintegridaddelarestriccinno sepuedegarantizarsilosfactoresdesencadenantesnoseejecutan.Elmecanismodedisparodedisparotambinseveafectadaporlavariablede configuracinsession_replication_role.Simplementedisparadoreshabilitadossedispararcuandolafuncindereplicacinesel"origen"(por defecto)o"local".DisparaconfiguradocomoA C T I V A RR E P L I C A slosedispararsilasesinesten"replica"elmodo,ydesencadena configuradocomoh a b i l i t a rs i e m p r e sedispararindependientementedelmododereproduccinactual.
D E S A C T I V A R /A C T I V A R[ R E P L I C A|S I E M P R E ]R E G L A

Estasformasdeconfigurareldisparodereglasdereescrituraquepertenecenalatabla.Unaregladeshabilitadotodavaseconocealsistema,pero noseaplicadurantelareescrituradelaconsulta.Lasemnticaescomodisparadoresparadiscapacitados/activado.Estaconfiguracinseignora s o b r ee lS e l e c t reglas,quesiempreseaplicanconelfindelograrvistastrabajandoinclusosilasesinactualestenunafuncinde replicacinnopredeterminada.

G R U P OD E

EstaformaseseleccionaelndicedemorosidadparalosfuturosRACIMOoperaciones.Nolohaceenrealidadreclusterdelamesa.
J U E G OS I NG R U P O

EstaformaeliminalautilizadamsrecientementeGRUPOespecificacindendicedelatabla.Estoafectaalasoperacionesdelclsterfuturos quenoseespecificaunndice.
S E TC O NO I D S

Estaformaagregaunao i d lacolumnadelsistemadelatabla(verseccin5.4).NohacenadasilatablayatieneOID. TengaencuentaqueestonoesequivalenteaA D DC O L U M No i dO I D ,queagregarunacolumnanormalquepasasernombradoo i d ,nouna columnadelsistema.


J U E G OS I NO I D S

Estaformaeliminaelo i d columnadesistemaapartirdelatabla.Estoesexactamenteequivalenteaq u i t a rl ac o l u m n ao i dR E S T R I C T , exceptoquenosequejarsiyahayo i d columna.


S E T(p a r m e t r o _ a l m a c e n a m i e n t o=v a l o r[ ,. . . ] )

Estaformacambiaunoomsparmetrosdealmacenamientoparalatabla.Verparmetrosdealmacenamientoparaobtenermsinformacin sobrelosparmetrosdisponibles.Tengaencuentaqueloscontenidosdelatablanosernmodificadosinmediatamenteporestecomando, dependiendodelparmetroquepuedeserquenecesitevolveraescribirlatablaparaconseguirlosefectosdeseados.Esosepuedehacerconel vacototal,GRUPOounadelasformasdeA L T E RT A B L E queobligaaunareescrituramesa. Nota:MientrasC R E A T ET A B L E permiteO I D S queseespecifiquenenelC O N(p a r m e t r o _ a l m a c e n a m i e n t o) sintaxisA L T E R T A B L E notrataO I D S comounparmetrodealmacenamiento.EnlugardeutilizarelS E TC O NO I D S yS E Ts i nO I D S formade cambiarelestadodeOID.
R E S E T(p a r m e t r o _ a l m a c e n a m i e n t o[ ,. . . ] )

Estaformaserestableceunoomsparmetrosdealmacenamientoasusvalorespredeterminados.AligualqueconS E T ,puedesernecesariauna reescrituramesaparaactualizarlatablaporcompleto.


I N H E R I Tt a b l a _ p a d r e

Estaformaagregalatabladedestinocomounnuevohijodelatablaprimariaespecificada.Posteriormente,lasconsultasenlospadresincluirn losregistrosdelatabladedestino.Paraserincluidocomounnio,latabladedestinoyadebecontenertodaslasmismascolumnasqueelpadre (quepodratenercolumnasadicionales,tambin).Lascolumnasdebentenertiposdedatoscoincidentes,ysihanN O TN U L L limitacionesenel padre,entoncestambindebentenerN O TN U L L limitacionesenelnio. TambindebehaberrestriccionesajuegodemesainfantilparatodosM o s t r a r restriccionesdelospadres,exceptolosmarcadoscomono hereditarios(esdecir,creadaconA L T E RT A B L E. . .A D DC O N S T R A I N T. . .N OI N H E R I T )enlamatriz,queseignorantodaslasrestriccionesde mesainfantilemparejadosnosedebenmarcarnoheredables.ActualmenteU N I Q U E ,P R I M A R YK E Y yF O R E I G NK E Y restriccionesnoseconsideran, peroestopodracambiarenelfuturo.
N OI N H E R I Tt a b l a _ p a d r e

Estaformaeliminalatabladedestinoenlalistadeloshijosdelatablaprimariaespecificada.Lasconsultasenlatablapadreyanoincluirlos registrosextradosdelatabladedestino.
D Et y p e _ n a m e

Estaformaunelatablaauntipocompuesto,comosiC R E A T ET A B L EO F habaformadol.Lalistadelatabladenombresdecolumnaylostipos debencoincidirexactamenteconladeltipocompuestoconlapresenciadeuno i d columnadesistemasepermitediferir.Latablanodebeheredar decualquierotratabla.EstasrestriccionesaseguranqueC R E A T ET A B L ED E permitiraunadefinicindelatablaequivalente.


N OD E

Esteformulariosedisociaunatablacontipodesutipo.
P R O P I E T A R I O

Estaformacambiaelpropietariodelatabla,secuencia,ovistaparaelusuarioespecificado.

S E TT A B L E S P A C E

Estaformacambiadetablasdelatablaparaelespaciodetablaespecificadoymueveelarchivodedatos(s)asociadosalamesaparaelnuevo espaciodetablas.Losndicesdelatabla,ensucaso,nosemueven,perosepuedenmoverporseparadoconadicionalesS E TT A B L E S P A C E comandos.VeatambinCREATETABLESPACE.


R E N A M E

LosR E N A M E formascambianelnombredeunatabla(ounndice,secuenciaovista),elnombredeunacolumnaindividualenunatabla,oel nombredeunarestriccindelatabla.Nohayningnefectoenlosdatosalmacenados.


S E TS C H E M A

Estaformasemuevelatablaenotroesquema.ndicesasociados,laslimitaciones,ylassecuenciasdepropiedaddelascolumnasdelatablase mueventambin. TodaslasaccionesexceptoR E N A M E yS E TS C H E M A sepuedencombinarenunalistademltiplesalteracionesdeaplicarenparalelo.Porejemplo,es posibleaadirvariascolumnasy/oalterareltipodevariascolumnasenunnicocomando.Estoesparticularmentetilcontablasdegrantamao,ya queslounapaselatablasenecesitahacer. RecuerdaquedebestenerlamesadeutilizarA L T E RT A B L E .Paracambiarelesquemadeunatabla,tambindebetenerC R E A R privilegioenelnuevo esquema.Paraagregarlatablacomounnuevohijodeunatablapadre,debeserelpropietariodelatablaprimariatambin.Paracambiarelpropietario, tambindebeserunmiembrodirectooindirectodelanuevafuncinqueposee,yqueelpapeldebehaberC R E A R privilegioenelesquemadelatabla. (Estasrestriccionesseimponenquelaalteracindeeldueonohacenadaquenosepodahacerporlacadayvolveracrearlatabla.Sinembargo,un superusuariopuedecambiarlapropiedaddecualquiermesadetodosmodos.)ParaagregarunacolumnaomodificaruntipodecolumnaoutilizarelD E clusula,tambindebetenerU S O privilegiodeltipodedatos.

Parmetros
n o m b r e

Elnombre(opcionalmentecalificadoporelesquema)deunatablaexistentedealterar.Sis l o seespecificaantesdequeelnombredelatabla, sloqueelcuadrosemodifica.Sis l o noseespecifica,eltodassustablasdescendientes(ensucaso)mesaysealteran.Opcionalmente,* se puedeespecificardespusdequeelnombredelatablaparaindicarexplcitamentequelastablasdescendientesestnincluidos.


c o l u m n _ n a m e

Nombredeunacolumnanuevaoexistente.
n e w _ c o l u m n _ n a m e

Nuevonombreparaunacolumnaexistente.
n o m b r e _ n u e v o

Nuevonombreparalatabla.
t i p o

Tipodedatosdelanuevacolumnaonuevotipodedatosparaunacolumnaexistente.
r e s t r i c c i n _ t a b l a

Nuevarestriccindetablaparalatabla.
c o n s t r a i n t _ n a m e

Nombredeunarestriccinexistenteacaer.
C A S C A D E

Colocarautomticamentelosobjetosquedependendelacolumnaoderestricciones(porejemplo,consideraquehacereferenciaalacolumna) cado.
R E S T R I N G I R

Senieganaabandonarlacolumnaorestriccinsihayobjetosdependientes.Esteeselcomportamientopredeterminado.

t r i g g e r _ n a m e

Nombredeunsolodisparadorparaactivarodesactivar.
T O D O

Activaodesactivatodoslosdisparadoresquepertenecenalatabla.(Estorequiereprivilegiosdesuperusuariosirestriccinalgunadelosfactores desencadenantessegeneraninternamentefactoresdesencadenantes,comolosqueseutilizanparaaplicarrestriccionesdeclavesforneaso singularidadprorrogableylasrestriccionesdeexclusin.)


U S U A R I O

Desactivaroactivartodoslosdisparadoresquepertenecenalatabla,exceptoparalarestriccingeneradosinternamentedesencadenantestales comolosqueseutilizanparaaplicarrestriccionesdeclavesforneasosingularidadprorrogableylasrestriccionesdeexclusin.
i n d e x _ n a m e

Elnombredelndiceenelquesedebemarcarlamesaparalaagrupacin.
p a r m e t r o _ a l m a c e n a m i e n t o

Elnombredeunparmetrodealmacenamientodelatabla.
v a l o r

Elnuevovalorparaunparmetrodealmacenamientodelatabla.Estopodraserunnmeroounapalabraenfuncindelparmetro.
t a b l a _ p a d r e

Unatablaprincipaldeasociarseodeasociadaconestatabla.
n e w _ o w n e r

Elnombredeusuariodelnuevopropietariodelatabla.
n e w _ t a b l e s p a c e

Elnombredelatablaalaquelamesasemover.
n e w _ s c h e m a

Elnombredelesquemaalquelamesasemover.

Notas
LapalabraclaveC O L U M N A eselruidoypuedeseromitida. CuandoseagregaunacolumnaconA D DC O L U M N ,todaslasfilasexistentesenlatablaseinicializanconelvalorpredeterminadodelacolumna(NULL sinoD E F A U L T seespecificalaclusula). Adicindeunacolumnaconunvalorpredeterminadoquenoseanuloocambiareltipodeunacolumnaexistenterequerirtodalatablaylosndicesa serreescritos.Comoexcepcin,sielU S O clusulanocambialoscontenidosdelacolumnayeltipoviejoesyaseabinariaconvertiblesenelnuevotipo oundominioirrestrictosobreelnuevotipo,noesnecesariaunareescrituramesa,perotodoslosndicesdelascolumnasafectadasdebentodavaser reconstruido.Adicinoeliminacindeunsistemao i d columnatambinrequierereescribirtodalatabla.Mesay/oreconstruccindendicepuede tomarunacantidadsignificativadetiempoparaunatablagrande,yrequerirtemporalmentetantocomoeldobledeespacioendisco. AdicindeunV E R oN O TN U L L restriccinrequiereescanearlatablaparaverificarquelasfilasexistentessatisfacenlarestriccin. LaraznprincipalparaproporcionarlaopcindeespecificarvarioscambiosenunsoloA L T E RT A B L E esqueescaneamltiplestablasoreescribecon ellosepuedencombinarenunasolapasadasobrelamesa. ElD R O PC O L U M N formanoeliminafsicamentelacolumna,sinoquesimplementehacequeseainvisibleparalasoperacionesdeSQL.Insercinposterior ylasoperacionesdeactualizacinenlatablaalmacenarunvalornuloparalacolumna.Porlotanto,dejandocaerunacolumnaesrpidaperonovaa reducirinmediatamenteeltamaoendiscodesumesa,yaqueelespacioocupadoporlacolumnaquitadanoserecupera.Elespacioserreclamadoen eltiempocomofilasexistentesseactualizan.(Estasdeclaracionesnosondeaplicacinaldejarelsistemao i d lacolumna,estosehaceconuna reescriturainmediata). Paraforzarunareescriturainmediatadelatabla,puedeutilizarelvacototal,GRUPOounadelasformasdeALTERTABLEqueobligaaunanueva

versin.Estodalugaraningncambiosemnticovisiblesenlatabla,perosedeshacedelosdatosqueyanosontiles. LaU S O opcindeD A T O SS E TT I P O realidadpuedeespecificarcualquierexpresinquelosviejosvaloresdelafila,esdecir,sepuedehacerreferenciaa otrascolumnas,ascomoelqueseestconvirtiendo.Estopermiteconversionesmuygeneralesqueserealizanconelt i p od ed a t o se s t a b l e c i d o sintaxis.Graciasaestaflexibilidad,laU S O expresinnoseaplicaalosvalorespredeterminadosdelacolumna(siloshubiera),elresultadonopuedeser unaexpresinconstantecomoserequiereparaundefecto.Estosignificaquesinohayconversinimplcitaoasignacindeloviejoanuevotipo,S E T D A T AT Y P E puedefallarparaconvertirelvalorpordefecto,aunqueaU T I L I Z A C I N sesuministraclusula.Entalescasos,dejecaerelvalorpordefecto conD R O PD E F A U L T ,realiceelA L T E RT Y P E ,yluegousarD E F A U L TS E T paraagregarunnuevovalorpredeterminadoadecuado.Consideraciones similaresseaplicanalosndicesylasrestriccionesqueimplicanlacolumna. Siunatablatienealgunatabladescendientes,noselepermiteagregar,cambiarelnombreocambiareltipodeunacolumna,ocambiarelnombredeuna restriccinheredadadelatablaprincipalsinhacerlomismoalosdescendientes.Esdecir,A L T E RT A B L EO N L Y serrechazada.Estoaseguraquelos descendientessiemprehancolumnasquecoincidaconelpadre. ArecursivaD R O PC O L U M N operacineliminarlacolumnadeunatabladedescendientesslosieldescendientenoheredalacolumnadecualquierotro padreynuncatuvounadefinicinindependientedelacolumna.AnorecursivaD R O PC O L U M N (esdecir,A L T E RT A B L E. . .D R O PC O L U M NO N L Y )no eliminalascolumnasdescendientes,sinoquelosquesedefinendeformaindependienteenlugardeheredadamarca. ElT R I G G E R ,G R U P O ,U N yT A B L E S P A C E accionesnuncarecursealastablasdescendientes,esdecir,quesiempreactancomosis l o seespecificaron. AdicindeunarestriccinrecursivamentesloparaV E R limitacionesquenoestnmarcadosN OI N H E R I T . Cambiosencualquierapartedeunatabladecatlogodelsistemanoestpermitido. ConsulteCREATETABLEparaunadescripcinmsdetalladadelosparmetrosvlidos.Captulo5tienemsinformacinsobrelaherencia.

Ejemplos
Paraagregarunacolumnadetipov a r c h a r aunatabla:
A L T E RT A B L Ed i s t r i b u i d o r e sA A D I RC O L U M N Ad i r e c c i nv a r c h a r( 3 0 ) ;

Paraeliminarunacolumnadeunatabla:
A L T E RT A B L Ed i s t r i b u i d o r e sD R O Pd i r e c c i nC O L U M N AR E S T R I N G I R ;

Paracambiarlostiposdedoscolumnasexistentesenunasolaoperacin:
A L T E RT A B L Ed i s t r i b u i d o r e s A L T E RC O L U M Nd i r e c c i nd et i p oV A R C H A R( 8 0 ) , A L T E RT Y P EC O L U M Nn o m b r ev a r c h a r( 1 0 0 ) ;

ParacambiarunacolumnadeenterosquecontienelasmarcasdetiempoUNIXt i m e s t a m pc o nl az o n ah o r a r i a atravsdeunU S O clusula:


A L T E RT A B L Ef o o A L T E RC O L U M Nf o o _ t i m e s t a m pc o n j u n t od ed a t o st i m e s t a m pT I P Od ez o n ah o r a r i a U S O F e c h ayh o r ac o nl az o n ah o r a r i a' p o c a '+f o o _ t i m e s t a m p*I n t e r v a l o' 1s e g u n d o' ;

Lomismo,cuandolacolumnatieneunaexpresinpordefectoquenodesecharautomticamentealnuevotipodedatos:
A L T E RT A B L Ef o o A L T E RC O L U M Nf o o _ t i m e s t a m pD R O PD E F A U L T , A L T E RC O L U M Nf o o _ t i m e s t a m pt i m e s t a m pT I P Od ez o n ah o r a r i a U S O F e c h ayh o r ac o nl az o n ah o r a r i a' p o c a '+f o o _ t i m e s t a m p*I n t e r v a l o' 1s e g u n d o' , A L T E RC O L U M Nf o o _ t i m e s t a m pS E TD E F A U L Tn o w( ) ;

Paracambiarelnombredeunacolumnaexistente:
A L T E RT A B L Ed i s t r i b u i d o r e sR E N A M Ed i r e c c i nC O L U M N AAc i u d a d ;

Paracambiarelnombredeunatablaexistente:
A L T E RT A B L Ed i s t r i b u i d o r e sR e n o m b r a rp a r al o sp r o v e e d o r e s ;

Paracambiarelnombredeunarestriccinexistente:
A L T E RT A B L Ed i s t r i b u i d o r e sR E N A M Ez i p c h kl i m i t a c i np a r az i p _ c h e c k ;

Paraagregarunarestriccinnonuloaunacolumna:
A L T E RT A B L Ed i s t r i b u i d o r e sA L T E Rc a l l eC O L U M N AS E TN O TN U L L ;

Paraeliminarunarestriccindenonuladeunacolumna:
A L T E RT A B L Ed i s t r i b u i d o r e sA L T E RC O L U M Nc a l l eD R O PN O TN U L L ;

ParaagregarunarestriccinCHECKaunatablaytodossushijos:
A L T E RT A B L Ed i s t r i b u i d o r e sz i p c h kA g r e g a rr e s t r i c c i nC H E C K( C H A R _ L E N G T H( c d i g op o s t a l )=5 ) ;

Paraagregarunarestriccindecomprobacinsloaunamesaynoasushijos:
A L T E RT A B L Ed i s t r i b u i d o r e sz i p c h kA g r e g a rr e s t r i c c i nC H E C K( C H A R _ L E N G T H( c d i g op o s t a l )=5 )N OI N H E R I T ;

(Larestriccindecomprobacinnoserheredadoporlosfuturoshijos,tampoco.) Paraeliminarunarestriccindecomprobacindeunatablaydetodossushijos:
A L T E RT A B L Ed i s t r i b u i d o r e sq u i t a rl ar e s t r i c c i nz i p c h k ;

Paraeliminarunarestriccindecomprobacindeunsolocuadro:
A L T E RT A B L Ed i s t r i b u i d o r e s n i c ar e s t r i c c i nD R O Pz i p c h k ;

(Larestriccindecomprobacinsemantienedurantealgntablassecundarias.) Paraagregarunarestriccindeclaveexternadeunatabla:
A L T E RT A B L Ed i s t r i b u i d o r e sd i s t f kA g r e g a rr e s t r i c c i nd ec l a v ee x t e r n a( d i r e c c i n )R E F E R E N C I A Sd i r e c c i o n e s( d i r e c c i o n e s ) ;

Paraagregaruna(variascolumnas)restriccinnicaparaunatabla:
A L T E RT A B L Ed i s t r i b u i d o r e sA g r e g a rr e s t r i c c i nd i s t _ i d _ z i p c o d e _ k e yU N I Q U E( d i s t _ i d ,c d i g op o s t a l ) ;

Paraagregarunarestriccindeclaveprimariallamadaautomticamenteaunamesa,observandoqueunamesatanslopuedetenerunaclaveprincipal:
A L T E RT A B L Ed i s t r i b u i d o r e sA D DP R I M A R YK E Y( d i s t _ i d ) ;

Paramoverunatablaenunespaciodetablasdiferente:
A L T E RT A B L Ed i s t r i b u i d o r e sS E TT A B L E S P A C Ef a s t t a b l e s p a c e ;

Paramoverunatablaaunesquemadiferente:
A L T E RT A B L ES E TS C H E M Am y s c h e m a . d i s t r i b u t o r sy o u r s c h e m a ;

Paravolveracrearunarestriccindeclaveprimaria,sinbloquearactualizacionesmientraselndicesevuelveacrear:
C R E A T EU N I Q U EI N D E XS I M U L T N E A M E N T EE Nd i s t _ i d _ t e m p _ i d xd i s t r i b u i d o r e s( d i s t _ i d ) ; A L T E RT A B L Ed i s t r i b u i d o r e sq u i t a rl ar e s t r i c c i nd i s t r i b u t o r s _ p k e y , A g r e g a rr e s t r i c c i nP R I M A R YK E Yd i s t r i b u t o r s _ p k e yU S O N D I C Ed i s t _ i d _ t e m p _ i d x ;

Compatibilidad
LasformasA D D (sinU S O N D I C E ),D R O P ,S E TD E F A U L T yS E TD ED A T O ST I P O (sinU S O )cumplirconelestndarSQL.Lasotrasformasson PostgreSQLextensionesdelestndarSQL.Adems,lacapacidaddeespecificarmsdeunamanipulacinenunsoloA L T E RT A B L E comandoesuna extensin.
A L T E RT A B L ED R O PC O L U M N A puedeusarseparadejarlanicacolumnadeunatabla,dejandountablecolumncero.EstaesunaextensindeSQL,que

desestimalastablasdecolumnacero.

Veatambin
CREATETABLE Anterior ALTERSERVER Casa Hasta Prximo ALTERTABLESPACE

Aadircomentario
UtiliceesteformularioparaagregarsuspropioscomentariosacercadesuexperienciaconlascaractersticasparticularesdePostgreSQL,aclaracionesde ladocumentacinosugerenciasparalosotrosusuarios.Tengaencuentaqueestoesnounforodesoporte,ysudireccinIPseregistrarn.Siusted

tieneunapreguntaonecesitaayuda,porfavorconsulteelFAQ,intenteunalistadecorreo,ounirseanosotrosenelIRC.Tengaencuentaquelos envosquecontienendireccionesURLopalabrasclavequeseencuentrancomnmenteenloscomentarios"spam"puedenserdescartados silenciosamente.Porfavor,pngaseencontactoconelwebmaster,siustedpiensaqueestoestocurriendoaustedenunerror. Contineconelformulariodecomentarios. Polticadeprivacidad|AcercadePostgreSQL Copyright19962013ElGrupoGlobaldeDesarrollodePostgreSQL

You might also like