Sintaxis SQL en Query Service

El servicio de consulta de Adobe Experience Platform permite utilizar ANSI SQL estándar para SELECT y otros comandos limitados. Este documento cubre la sintaxis SQL admitida por Query Service.

Consultas SELECT

La siguiente sintaxis define una SELECT consulta admitida por Query Service:

[ WITH with_query [, ...] ]
SELECT [ ALL | DISTINCT [( expression [, ...] ) ] ]
    [ * | expression [ [ AS ] output_name ] [, ...] ]
    [ FROM from_item [, ...] ]
    [ SNAPSHOT { SINCE start_snapshot_id | AS OF end_snapshot_id | BETWEEN start_snapshot_id AND end_snapshot_id } ]
    [ WHERE condition ]
    [ GROUP BY grouping_element [, ...] ]
    [ HAVING condition [, ...] ]
    [ WINDOW window_name AS ( window_definition ) [, ...] ]
    [ { UNION | INTERSECT | EXCEPT | MINUS } [ ALL | DISTINCT ] select ]
    [ ORDER BY expression [ ASC | DESC | USING operator ] [ NULLS { FIRST | LAST } ] [, ...] ]
    [ LIMIT { count | ALL } ]
    [ OFFSET start ]

donde from_item puede ser una de las siguientes opciones:

table_name [ * ] [ [ AS ] alias [ ( column_alias [, ...] ) ] ]

[ LATERAL ] ( select ) [ AS ] alias [ ( column_alias [, ...] ) ]

with_query_name [ [ AS ] alias [ ( column_alias [, ...] ) ] ]

from_item [ NATURAL ] join_type from_item [ ON join_condition | USING ( join_column [, ...] ) ]

y grouping_element puede ser una de las siguientes opciones:

( )

expression

( expression [, ...] )

ROLLUP ( { expression | ( expression [, ...] ) } [, ...] )

CUBE ( { expression | ( expression [, ...] ) } [, ...] )

GROUPING SETS ( grouping_element [, ...] )

y with_query es:

 with_query_name [ ( column_name [, ...] ) ] AS ( select | values )

Las siguientes subsecciones proporcionan detalles sobre cláusulas adicionales que puede utilizar en sus consultas, siempre que sigan el formato descrito anteriormente.

Cláusula SNAPSHOT

Esta cláusula se puede utilizar para leer datos de forma incremental en una tabla basada en los ID de instantánea. Un ID de instantánea es un marcador de punto de comprobación representado por un número de tipo Long que se aplica a una tabla de lago de datos cada vez que se escriben datos en ella. La variable SNAPSHOT se adjunta a la relación de tabla a la que se utiliza junto.

    [ SNAPSHOT { SINCE start_snapshot_id | AS OF end_snapshot_id | BETWEEN start_snapshot_id AND end_snapshot_id } ]

Ejemplo

SELECT * FROM Customers SNAPSHOT SINCE 123;

SELECT * FROM Customers SNAPSHOT AS OF 345;

SELECT * FROM Customers SNAPSHOT BETWEEN 123 AND 345;

SELECT * FROM Customers SNAPSHOT BETWEEN HEAD AND 123;

SELECT * FROM Customers SNAPSHOT BETWEEN 345 AND TAIL;

SELECT * FROM (SELECT id FROM CUSTOMERS BETWEEN 123 AND 345) C

SELECT * FROM Customers SNAPSHOT SINCE 123 INNER JOIN Inventory AS OF 789 ON Customers.id = Inventory.id;

Tenga en cuenta que SNAPSHOT funciona con un alias de tabla o tabla, pero no sobre una subconsulta o vista. A SNAPSHOT la cláusula funcionará en cualquier lugar a SELECT se puede aplicar una consulta en una tabla.

Además, puede utilizar HEAD y TAIL como valores de desplazamiento especiales para cláusulas de instantánea. Uso HEAD hace referencia a un desplazamiento antes de la primera instantánea, mientras que TAIL hace referencia a un desplazamiento después de la última instantánea.

cláusula WHERE

De forma predeterminada, las coincidencias producidas por un WHERE cláusula sobre SELECT distinguen entre mayúsculas y minúsculas. Si desea que las coincidencias no distingan entre mayúsculas y minúsculas, puede utilizar la palabra clave ILIKE en lugar de LIKE.

    [ WHERE condition { LIKE | ILIKE | NOT LIKE | NOT ILIKE } pattern ]

La lógica de las cláusulas LIKE e ILIKE se explica en la siguiente tabla:

Cláusula	Operador
WHERE condition LIKE pattern	~~
WHERE condition NOT LIKE pattern	!~~
WHERE condition ILIKE pattern	~~*
WHERE condition NOT ILIKE pattern	!~~*

Ejemplo

SELECT * FROM Customers
WHERE CustomerName ILIKE 'a%';

Esta consulta devuelve clientes con nombres que comienzan en "A" o "a".

UNIR

A SELECT la consulta que utiliza uniones tiene la siguiente sintaxis:

SELECT statement
FROM statement
[JOIN | INNER JOIN | LEFT JOIN | LEFT OUTER JOIN | RIGHT JOIN | RIGHT OUTER JOIN | FULL JOIN | FULL OUTER JOIN]
ON join condition

UNIÓN, INTERSECCIÓN y EXCEPTO

La variable UNION, INTERSECTy EXCEPT se utilizan para combinar o excluir filas similares de dos o más tablas:

SELECT statement 1
[UNION | UNION ALL | UNION DISTINCT | INTERSECT | EXCEPT | MINUS]
SELECT statement 2

CREAR TABLA COMO SELECCIONE

La siguiente sintaxis define una CREATE TABLE AS SELECT (CTAS) consulta:

CREATE TABLE table_name [ WITH (schema='target_schema_title', rowvalidation='false') ] AS (select_query)

Parámetros	Descripción
schema	Título del esquema XDM. Utilice esta cláusula solo si desea utilizar un esquema XDM existente para el nuevo conjunto de datos creado por la consulta CTAS.
rowvalidation	(Opcional) Especifica si el usuario desea la validación de nivel de fila de cada lote nuevo introducido para el conjunto de datos recién creado. El valor predeterminado es true.
select_query	A SELECT instrucción. La sintaxis de la variable SELECT La consulta se puede encontrar en el Sección SELECT queries.

Ejemplo

CREATE TABLE Chairs AS (SELECT color, count(*) AS no_of_chairs FROM Inventory i WHERE i.type=="chair" GROUP BY i.color)

CREATE TABLE Chairs WITH (schema='target schema title') AS (SELECT color, count(*) AS no_of_chairs FROM Inventory i WHERE i.type=="chair" GROUP BY i.color)

CREATE TABLE Chairs AS (SELECT color FROM Inventory SNAPSHOT SINCE 123)

INSERTAR EN

La variable INSERT INTO se define de la siguiente manera:

INSERT INTO table_name select_query

Parámetros	Descripción
table_name	El nombre de la tabla en la que desea insertar la consulta.
select_query	A SELECT instrucción. La sintaxis de la variable SELECT La consulta se puede encontrar en el Sección SELECT queries.

Ejemplo

INSERT INTO Customers SELECT SupplierName, City, Country FROM OnlineCustomers;

INSERT INTO Customers AS (SELECT * from OnlineCustomers SNAPSHOT AS OF 345)

La mayoría de los campos de un esquema XDM real no se encuentran en el nivel raíz y SQL no permite el uso de la notación de puntos. Para obtener un resultado realista mediante campos anidados, debe asignar cada campo en la INSERT INTO ruta.

Hasta INSERT INTO rutas anidadas, utilice la siguiente sintaxis:

INSERT INTO [dataset]
SELECT struct([source field1] as [target field in schema],
[source field2] as [target field in schema],
[source field3] as [target field in schema]) [tenant name]
FROM [dataset]

Ejemplo

INSERT INTO Customers SELECT struct(SupplierName as Supplier, City as SupplierCity, Country as SupplierCountry) _Adobe FROM OnlineCustomers;

TABLA DE COLOCACIÓN

La variable DROP TABLE suelta una tabla existente y elimina el directorio asociado con la tabla del sistema de archivos si no es una tabla externa. Si la tabla no existe, se produce una excepción.

DROP TABLE [IF EXISTS] [db_name.]table_name

Parámetros	Descripción
IF EXISTS	Si se especifica esto, no se genera ninguna excepción si la tabla not existe.

CREAR BASE DE DATOS

La variable CREATE DATABASE crea una base de datos ADLS.

CREATE DATABASE [IF NOT EXISTS] db_name

SOLTAR BASE DE DATOS

La variable DROP DATABASE elimina la base de datos de una instancia.

DROP DATABASE [IF EXISTS] db_name

Parámetros	Descripción
IF EXISTS	Si se especifica esto, no se genera ninguna excepción si la base de datos not existe.

ESQUEMA DE COLOCACIÓN

La variable DROP SCHEMA coloca un esquema existente.

DROP SCHEMA [IF EXISTS] db_name.schema_name [ RESTRICT | CASCADE]

Parámetros	Descripción
IF EXISTS	Si se especifica esto, no se genera ninguna excepción si el esquema sí not existe.
RESTRICT	Valor predeterminado para el modo . Si se especifica esto, el esquema solo se perderá si no contiene cualquier tabla.
CASCADE	Si se especifica esto, el esquema se perderá junto con todas las tablas presentes en el esquema.

CREAR VISTA

La siguiente sintaxis define una CREATE VIEW consulta:

CREATE VIEW view_name AS select_query

Parámetros	Descripción
view_name	Nombre de la vista que se va a crear.
select_query	A SELECT instrucción. La sintaxis de la variable SELECT La consulta se puede encontrar en el Sección SELECT queries.

Ejemplo

CREATE VIEW V1 AS SELECT color, type FROM Inventory

CREATE OR REPLACE VIEW V1 AS SELECT model, version FROM Inventory

VISTA DE COLOCACIÓN

La siguiente sintaxis define una DROP VIEW consulta:

DROP VIEW [IF EXISTS] view_name

Parámetros	Descripción
IF EXISTS	Si se especifica esto, no se genera ninguna excepción si la vista not existe.
view_name	Nombre de la vista que se va a eliminar.

Ejemplo

DROP VIEW v1
DROP VIEW IF EXISTS v1

Bloque anónimo

Un bloque anónimo consta de dos secciones: secciones ejecutables y de control de excepciones. En un bloque anónimo, la sección ejecutable es obligatoria. Sin embargo, la sección de control de excepciones es opcional.

El siguiente ejemplo muestra cómo crear un bloque con una o más instrucciones que se van a ejecutar juntas:

BEGIN
  statementList
[EXCEPTION exceptionHandler]
END

exceptionHandler:
      WHEN OTHER
      THEN statementList

statementList:
    : (statement (';')) +

A continuación, se muestra un ejemplo con bloque anónimo.

BEGIN
   SET @v_snapshot_from = select parent_id  from (select history_meta('email_tracking_experience_event_dataset') ) tab where is_current;
   SET @v_snapshot_to = select snapshot_id from (select history_meta('email_tracking_experience_event_dataset') ) tab where is_current;
   SET @v_log_id = select now();
   CREATE TABLE tracking_email_id_incrementally
     AS SELECT _id AS id FROM email_tracking_experience_event_dataset SNAPSHOT BETWEEN @v_snapshot_from AND @v_snapshot_to;

EXCEPTION
  WHEN OTHER THEN
    DROP TABLE IF EXISTS tracking_email_id_incrementally;
    SELECT 'ERROR';
END;

Organización de recursos de datos

Es importante organizar lógicamente los recursos de datos dentro del lago de datos de Adobe Experience Platform a medida que crezcan. El servicio de consulta amplía las construcciones SQL que permiten agrupar lógicamente recursos de datos dentro de un simulador para pruebas. Este método de organización permite compartir recursos de datos entre esquemas sin necesidad de moverlos físicamente.

Las siguientes construcciones SQL que utilizan sintaxis SQL estándar son compatibles para organizar lógicamente los datos.

CREATE DATABASE dg1;
CREATE SCHEMA dg1.schema1;
CREATE table t1 ...;
CREATE view v1 ...;
ALTER TABLE t1 ADD PRIMARY KEY (c1) NOT ENFORCED;
ALTER TABLE t2 ADD FOREIGN KEY (c1) REFERENCES t1(c1) NOT ENFORCED;

Consulte la guía de organización lógica de los recursos de datos para obtener más información detallada sobre las prácticas recomendadas del servicio de consulta.

La tabla existe

La variable table_exists El comando SQL se utiliza para confirmar si existe o no una tabla en el sistema. El comando devuelve un valor booleano: true si la tabla does existe, y false si la tabla lo hace not existe.

Al validar si existe una tabla antes de ejecutar las instrucciones, la variable table_exists simplifica el proceso de escritura de un bloque anónimo para cubrir ambas CREATE y INSERT INTO casos de uso.

La siguiente sintaxis define la variable table_exists comando:

$$
BEGIN

#Set mytableexist to true if the table already exists.
SET @mytableexist = SELECT table_exists('target_table_name');

#Create the table if it does not already exist (this is a one time operation).
CREATE TABLE IF NOT EXISTS target_table_name AS
  SELECT *
  FROM   profile_dim_date limit 10;

#Insert data only if the table already exists. Check if @mytableexist = 'true'
 INSERT INTO target_table_name           (
                     select *
                     from   profile_dim_date
                     WHERE  @mytableexist = 'true' limit 20
              ) ;
EXCEPTION
WHEN other THEN SELECT 'ERROR';

END $$;

En línea

La variable inline separa los elementos de una matriz de estructuras y genera los valores en una tabla. Solo se puede colocar en la variable SELECT lista o LATERAL VIEW.

La variable inline function cannot se colocarán en una lista de selección donde haya otras funciones generadoras.

De forma predeterminada, las columnas producidas se denominan "col1", "col2", etc. Si la expresión es NULL a continuación, no se genera ninguna fila.

Ejemplo

> SELECT inline(array(struct(1, 'a'), struct(2, 'b'))), 'Spark SQL';

El ejemplo devuelve lo siguiente:

1  a Spark SQL
2  b Spark SQL

Este segundo ejemplo demuestra aún más el concepto y la aplicación del inline función. El modelo de datos del ejemplo se ilustra en la siguiente imagen.

Ejemplo

select inline(productListItems) from source_dataset limit 10;

Los valores tomados de la variable source_dataset se utilizan para rellenar la tabla de destino.

SKU	_experiencia	cantidad	priceTotal
product-id-1	("("("("(A,pass,B,NULL")")")")	5	10,5
product-id-5	("("("(A, pass, B,NULL")")"))
product-id-2	("("("(AF, C, D,NULL")")"))	6	40
product-id-4	("("("(BM, pass, NA,NULL)")")")	3	12

Spark Comandos SQL

La subsección siguiente cubre los comandos Spark SQL admitidos por el servicio de consulta.

SET

La variable SET establece una propiedad y devuelve el valor de una propiedad existente o enumera todas las propiedades existentes. Si se proporciona un valor para una clave de propiedad existente, se anula el valor antiguo.

SET property_key = property_value

Parámetros	Descripción
property_key	El nombre de la propiedad que desea enumerar o modificar.
property_value	El valor que desea que la propiedad se establezca como.

Para devolver el valor de cualquier configuración, utilice SET [property key] sin property_value.

Comandos PostgreSQL

Las subsecciones siguientes abarcan los comandos PostgreSQL admitidos por el servicio de consultas.

INICIO

La variable BEGIN o, alternativamente, la variable BEGIN WORK o BEGIN TRANSACTION inicia un bloque de transacción. Cualquier instrucción que se introduzca después del comando begin se ejecutará en una sola transacción hasta que se proporcione un comando COMMIT o ROLLBACK explícito. Este comando es el mismo que START TRANSACTION.

BEGIN
BEGIN WORK
BEGIN TRANSACTION

CERRAR

La variable CLOSE libera los recursos asociados con un cursor abierto. Una vez cerrado el cursor, no se permiten operaciones posteriores en él. Se debe cerrar un cursor cuando ya no se necesite.

CLOSE name
CLOSE ALL

If CLOSE name se utiliza, name representa el nombre de un cursor abierto que debe cerrarse. If CLOSE ALL se utiliza, se cerrarán todos los cursores abiertos.

DESASIGNAR

La variable DEALLOCATE permite deslocalizar una instrucción SQL previamente preparada. Si no asigna explícitamente una instrucción preparada, se desasigna al finalizar la sesión. Puede encontrar más información sobre las declaraciones preparadas en la sección PREPARAR, comando para obtener más información.

DEALLOCATE name
DEALLOCATE ALL

If DEALLOCATE name se utiliza, name representa el nombre de la declaración preparada que debe desasignarse. If DEALLOCATE ALL se utiliza, se desasignarán todas las instrucciones preparadas.

DECLARAR

La variable DECLARE permite al usuario crear un cursor, que se puede utilizar para recuperar un pequeño número de filas de una consulta más grande. Una vez creado el cursor, las filas se recuperan de él mediante FETCH.

DECLARE name CURSOR FOR query

Parámetros	Descripción
name	Nombre del cursor que se va a crear.
query	A SELECT o VALUES que proporciona las filas que devolverá el cursor.

EJECUTAR

La variable EXECUTE se utiliza para ejecutar una instrucción previamente preparada. Dado que las declaraciones preparadas sólo existen durante el período de sesiones, la declaración preparada debe haber sido creada por un PREPARE ejecutada anteriormente en la sesión actual. Puede encontrar más información sobre el uso de las declaraciones preparadas en la sección PREPARE command para obtener más información.

Si la variable PREPARE que creó la sentencia especificó algunos parámetros, se debe pasar un conjunto compatible de parámetros a la EXECUTE instrucción. Si estos parámetros no se pasan, se generará un error.

EXECUTE name [ ( parameter ) ]

Parámetros	Descripción
name	Nombre de la instrucción preparada que se va a ejecutar.
parameter	El valor real de un parámetro en la instrucción preparada. Debe ser una expresión que genere un valor compatible con el tipo de datos de este parámetro, tal como se determina cuando se creó la instrucción preparada. Si hay varios parámetros para la instrucción preparada, se separan con comas.

EXPLAIN

La variable EXPLAIN muestra el plan de ejecución de la instrucción suministrada. El plan de ejecución muestra cómo se analizan las tablas a las que hace referencia la instrucción. Si se hace referencia a varias tablas, se mostrará qué algoritmos de unión se utilizan para unir las filas necesarias de cada tabla de entrada.

EXPLAIN option statement

Donde option puede ser uno de los siguientes:

ANALYZE
FORMAT { TEXT | JSON }

Parámetros	Descripción
ANALYZE	Si la variable option contains ANALYZE, se muestran los tiempos de ejecución y otras estadísticas.
FORMAT	Si la variable option contains FORMAT, especifica el formato de salida, que puede ser TEXT o JSON. La salida no textual contiene la misma información que el formato de salida de texto, pero es más fácil de analizar para los programas. El valor predeterminado de este parámetro es TEXT.
statement	Cualquiera SELECT, INSERT, UPDATE, DELETE, VALUES, EXECUTE, DECLARE, CREATE TABLE ASo CREATE MATERIALIZED VIEW AS cuyo plan de ejecución desea ver.

Ejemplo

El siguiente ejemplo muestra el plan para una consulta simple en una tabla con un solo integer y 10 000 filas:

EXPLAIN SELECT * FROM foo;

                       QUERY PLAN
---------------------------------------------------------
 Seq Scan on foo  (cost=0.00..155.00 rows=10000 width=4)
(1 row)

RECUPERAR

La variable FETCH recupera filas utilizando un cursor creado anteriormente.

FETCH num_of_rows [ IN | FROM ] cursor_name

Parámetros	Descripción
num_of_rows	Número de filas que se van a recuperar.
cursor_name	Nombre del cursor desde el que se recupera la información.

PREPARAR

La variable PREPARE permite crear una instrucción preparada. Una instrucción preparada es un objeto del lado del servidor que puede utilizarse para crear plantillas de sentencias SQL similares.

Las instrucciones preparadas pueden tomar parámetros, que son valores que se sustituyen en la instrucción cuando se ejecuta. Los parámetros se remiten por posición, utilizando $1, $2, etc., al utilizar instrucciones preparadas.

De forma opcional, puede especificar una lista de tipos de datos de parámetros. Si el tipo de datos de un parámetro no aparece en la lista, el tipo se puede inferir desde el contexto.

PREPARE name [ ( data_type [, ...] ) ] AS SELECT

Parámetros	Descripción
name	Nombre de la declaración preparada.
data_type	Tipos de datos de los parámetros de la instrucción preparada. Si el tipo de datos de un parámetro no aparece en la lista, el tipo se puede inferir desde el contexto. Si necesita agregar varios tipos de datos, puede agregarlos en una lista separada por comas.

RETROSPECTIVA

La variable ROLLBACK deshace la transacción actual y descarta todas las actualizaciones realizadas por la transacción.

ROLLBACK
ROLLBACK WORK

SELECCIONAR EN

La variable SELECT INTO crea una nueva tabla y la rellena con datos calculados por una consulta. Los datos no se devuelven al cliente, como sucede con una SELECT comando. Las columnas de la nueva tabla tienen los nombres y tipos de datos asociados con las columnas de salida de la SELECT comando.

[ WITH [ RECURSIVE ] with_query [, ...] ]
SELECT [ ALL | DISTINCT [ ON ( expression [, ...] ) ] ]
    * | expression [ [ AS ] output_name ] [, ...]
    INTO [ TEMPORARY | TEMP | UNLOGGED ] [ TABLE ] new_table
    [ FROM from_item [, ...] ]
    [ WHERE condition ]
    [ GROUP BY expression [, ...] ]
    [ HAVING condition [, ...] ]
    [ WINDOW window_name AS ( window_definition ) [, ...] ]
    [ { UNION | INTERSECT | EXCEPT } [ ALL | DISTINCT ] select ]
    [ ORDER BY expression [ ASC | DESC | USING operator ] [ NULLS { FIRST | LAST } ] [, ...] ]
    [ LIMIT { count | ALL } ]
    [ OFFSET start [ ROW | ROWS ] ]
    [ FETCH { FIRST | NEXT } [ count ] { ROW | ROWS } ONLY ]
    [ FOR { UPDATE | SHARE } [ OF table_name [, ...] ] [ NOWAIT ] [...] ]

Puede encontrar más información sobre los parámetros de consulta SELECT estándar en la Sección de consulta SELECT. Esta sección solo enumerará los parámetros que son exclusivos de SELECT INTO comando.

Parámetros	Descripción
TEMPORARY o TEMP	Un parámetro opcional. Si se especifica, la tabla que se crea será una tabla temporal.
UNLOGGED	Un parámetro opcional. Si se especifica, la tabla que se crea como será una tabla sin registrar. Puede encontrar más información sobre las tablas no registradas en la Documentación PostgreSQL.
new_table	Nombre de la tabla que se va a crear.

Ejemplo

La siguiente consulta crea una nueva tabla films_recent que consiste únicamente en entradas recientes de la tabla films:

SELECT * INTO films_recent FROM films WHERE date_prod >= '2002-01-01';

MOSTRAR

La variable SHOW muestra la configuración actual de los parámetros de tiempo de ejecución. Estas variables se pueden configurar usando la variable SET , editando la variable postgresql.conf a través del PGOPTIONS variable ambiental (cuando se usa libpq o una aplicación basada en libpq), o a través de indicadores de línea de comandos al iniciar el servidor Postgres.

SHOW name
SHOW ALL

Parámetros	Descripción
name	Nombre del parámetro de tiempo de ejecución del que desea obtener información. Los valores posibles del parámetro de tiempo de ejecución incluyen los siguientes valores: SERVER_VERSION: Este parámetro muestra el número de versión del servidor. SERVER_ENCODING: Este parámetro muestra la codificación del conjunto de caracteres del lado del servidor. LC_COLLATE: Este parámetro muestra la configuración regional de la base de datos para la intercalación (orden de texto). LC_CTYPE: Este parámetro muestra la configuración regional de la base de datos para la clasificación de caracteres. IS_SUPERUSER: Este parámetro muestra si la función actual tiene privilegios de superusuario.
ALL	Mostrar los valores de todos los parámetros de configuración con descripciones.

Ejemplo

La siguiente consulta muestra la configuración actual del parámetro DateStyle.

SHOW DateStyle;

 DateStyle
-----------
 ISO, MDY
(1 row)

COPIAR

La variable COPY duplica la salida de cualquier SELECT a una ubicación especificada. El usuario debe tener acceso a esta ubicación para que este comando se ejecute correctamente.

COPY query
    TO '%scratch_space%/folder_location'
    [  WITH FORMAT 'format_name']

Parámetros	Descripción
query	La consulta que desea copiar.
format_name	El formato en el que desea copiar la consulta. La variable format_name puede ser uno de parquet, csvo json. De forma predeterminada, el valor es parquet.

MODIFICAR TABLA

La variable ALTER TABLE permite añadir o soltar restricciones de claves principales o externas, así como agregar columnas a la tabla.

AÑADIR o SOLTAR RESTRICCIÓN

Las siguientes consultas SQL muestran ejemplos de adición o colocación de restricciones en una tabla.

ALTER TABLE table_name ADD CONSTRAINT PRIMARY KEY ( column_name ) NAMESPACE namespace

ALTER TABLE table_name ADD CONSTRAINT FOREIGN KEY ( column_name ) REFERENCES referenced_table_name ( primary_column_name )

ALTER TABLE table_name ADD CONSTRAINT PRIMARY IDENTITY ( column_name ) NAMESPACE namespace

ALTER TABLE table_name ADD CONSTRAINT IDENTITY ( column_name ) NAMESPACE namespace

ALTER TABLE table_name DROP CONSTRAINT PRIMARY KEY ( column_name )

ALTER TABLE table_name DROP CONSTRAINT FOREIGN KEY ( column_name )

ALTER TABLE table_name DROP CONSTRAINT PRIMARY IDENTITY ( column_name )

ALTER TABLE table_name DROP CONSTRAINT IDENTITY ( column_name )

Parámetros	Descripción
table_name	El nombre de la tabla que está editando.
column_name	Nombre de la columna a la que está agregando una restricción.
referenced_table_name	El nombre de la tabla a la que hace referencia la clave externa.
primary_column_name	Nombre de la columna a la que se hace referencia mediante la clave externa.

Agregar o eliminar identidades primarias y secundarias

La variable ALTER TABLE permite agregar o eliminar restricciones para columnas de tabla de identidad primarias y secundarias directamente a través de SQL.

En los ejemplos siguientes se añade una identidad principal y una identidad secundaria mediante la adición de restricciones.

ALTER TABLE t1 ADD CONSTRAINT PRIMARY IDENTITY (id) NAMESPACE 'IDFA';
ALTER TABLE t1 ADD CONSTRAINT IDENTITY(id) NAMESPACE 'IDFA';

Las identidades también se pueden eliminar eliminando restricciones, como se ve en el siguiente ejemplo.

ALTER TABLE t1 DROP CONSTRAINT PRIMARY IDENTITY (c1) ;
ALTER TABLE t1 DROP CONSTRAINT IDENTITY (c1) ;

Consulte el documento en configuración de identidades en conjuntos de datos ad hoc para obtener información más detallada.

AGREGAR COLUMNA

Las siguientes consultas SQL muestran ejemplos de adición de columnas a una tabla.

ALTER TABLE table_name ADD COLUMN column_name data_type

ALTER TABLE table_name ADD COLUMN column_name_1 data_type1, column_name_2 data_type2

Tipos de datos compatibles

La tabla siguiente muestra los tipos de datos aceptados para agregar columnas a una tabla con Postgres SQL, XDM y Accelerated Database Recovery (ADR) en Azure SQL.

—	Cliente PSQL	XDM	ADR	Descripción
1	bigint	int8	bigint	Tipo de datos numéricos que se utiliza para almacenar enteros grandes que van desde -9.223.372.036.854.775.807 a 9.223.372.036.854.775.807 en 8 bytes.
2	integer	int4	integer	Un tipo de datos numérico utilizado para almacenar números enteros que van de -2.147.483.648 a 2.147.483.647 en 4 bytes.
3	smallint	int2	smallint	Tipo de datos numéricos que se utiliza para almacenar números enteros que van de -32.768 a 215-1 32.767 en 2 bytes.
4	tinyint	int1	tinyint	Tipo de datos numéricos que se utiliza para almacenar números enteros que van de 0 a 255 en 1 byte.
5	varchar(len)	string	varchar(len)	Tipo de datos de caracteres de tamaño variable. varchar es mejor utilizarlo cuando los tamaños de las entradas de datos de la columna varían considerablemente.
6	double	float8	double precision	FLOAT8 y FLOAT son sinónimos válidos para DOUBLE PRECISION. double precision es un tipo de datos de coma flotante. Los valores de punto flotante se almacenan en 8 bytes.
7	double precision	float8	double precision	FLOAT8 es un sinónimo válido para double precision.double precision es un tipo de datos de coma flotante. Los valores de punto flotante se almacenan en 8 bytes.
8	date	date	date	La variable date los tipos de datos son valores de fecha del calendario almacenados de 4 bytes sin información de marca de tiempo. El rango de fechas válidas va del 01-01-0001 al 12-31-9999.
9	datetime	datetime	datetime	Tipo de datos que se utiliza para almacenar un instante en tiempo expresado como fecha y hora del día del calendario. datetime incluye los calificadores de: año, mes, día, hora, segundo y fracción. A datetime puede incluir cualquier subconjunto de estas unidades de tiempo unidas en esa secuencia, o incluso incluir una sola unidad de tiempo.
10	char(len)	string	char(len)	La variable char(len) palabra clave se usa para indicar que el elemento es de longitud fija.

AGREGAR ESQUEMA

La siguiente consulta SQL muestra un ejemplo de adición de una tabla a una base de datos/esquema.

ALTER TABLE table_name ADD SCHEMA database_name.schema_name

QUITAR ESQUEMA

La siguiente consulta SQL muestra un ejemplo de eliminación de una tabla de una base de datos/esquema.

ALTER TABLE table_name REMOVE SCHEMA database_name.schema_name

Parámetros

Parámetros	Descripción
table_name	El nombre de la tabla que está editando.
column_name	El nombre de la columna que desea agregar.
data_type	El tipo de datos de la columna que desea agregar. Los tipos de datos admitidos son los siguientes: bigint, char, cadena, fecha, fecha, hora de fecha, doble, precisión doble, entero, smallint, tinyint, varchar.

MOSTRAR CLAVES PRINCIPALES

La variable SHOW PRIMARY KEYS enumera todas las restricciones de claves principales de la base de datos dada.

SHOW PRIMARY KEYS

    tableName | columnName    | datatype | namespace
------------------+----------------------+----------+-----------
 table_name_1 | column_name1  | text     | "ECID"
 table_name_2 | column_name2  | text     | "AAID"

MOSTRAR CLAVES EXTRANJERAS

La variable SHOW FOREIGN KEYS enumera todas las restricciones de claves externas para la base de datos dada.

SHOW FOREIGN KEYS

    tableName   |     columnName      | datatype | referencedTableName | referencedColumnName | namespace
------------------+---------------------+----------+---------------------+----------------------+-----------
 table_name_1   | column_name1        | text     | table_name_3        | column_name3         |  "ECID"
 table_name_2   | column_name2        | text     | table_name_4        | column_name4         |  "AAID"

MOSTRAR GRUPOS DE DATOS

La variable SHOW DATAGROUPS devuelve una tabla de todas las bases de datos asociadas. Para cada base de datos, la tabla incluye esquema, tipo de grupo, tipo secundario, nombre secundario e ID secundario.

SHOW DATAGROUPS

   Database   |      Schema       | GroupType |      ChildType       |                     ChildName                       |               ChildId
  -------------+-------------------+-----------+----------------------+----------------------------------------------------+--------------------------------------
   adls_db     | adls_scheema      | ADLS      | Data Lake Table      | adls_table1                                        | 6149ff6e45cfa318a76ba6d3
   adls_db     | adls_scheema      | ADLS      | Data Warehouse Table | _table_demo1                                       | 22df56cf-0790-4034-bd54-d26d55ca6b21
   adls_db     | adls_scheema      | ADLS      | View                 | adls_view1                                         | c2e7ddac-d41c-40c5-a7dd-acd41c80c5e9
   adls_db     | adls_scheema      | ADLS      | View                 | adls_view4                                         | b280c564-df7e-405f-80c5-64df7ea05fc3

MOSTRAR GRUPOS DE DATOS PARA LA tabla

La variable SHOW DATAGROUPS FOR El comando 'table_name' devuelve una tabla de todas las bases de datos asociadas que contienen el parámetro como secundario. Para cada base de datos, la tabla incluye esquema, tipo de grupo, tipo secundario, nombre secundario e ID secundario.

SHOW DATAGROUPS FOR 'table_name'

Parámetros

• table_name: Nombre de la tabla para la que desea buscar bases de datos asociadas.

   Database   |      Schema       | GroupType |      ChildType       |                     ChildName                      |               ChildId
  -------------+-------------------+-----------+----------------------+----------------------------------------------------+--------------------------------------
   dwh_db_demo | schema2           | QSACCEL   | Data Warehouse Table | _table_demo2                                       | d270f704-0a65-4f0f-b3e6-cb535eb0c8ce
   dwh_db_demo | schema1           | QSACCEL   | Data Warehouse Table | _table_demo2                                       | d270f704-0a65-4f0f-b3e6-cb535eb0c8ce
   qsaccel     | profile_aggs      | QSACCEL   | Data Warehouse Table | _table_demo2                                       | d270f704-0a65-4f0f-b3e6-cb535eb0c8ce