

 O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# PG\$1GET\$1COLS
<a name="PG_GET_COLS"></a>

Retorna os metadados de coluna para uma definição de tabela ou de exibição.

## Sintaxe
<a name="PG_GET_COLS-synopsis"></a>

```
pg_get_cols('name')
```

## Argumentos
<a name="PG_GET_COLS-arguments"></a>

 *name*   
O nome de uma tabela ou visualização do Amazon Redshift. Para obter mais informações, consulte [Nomes e identificadores](r_names.md).

## Tipo de retorno
<a name="PG_GET_COLS-return-type"></a>

VARCHAR 

## Observações de uso
<a name="PG_GET_COLS-usage-notes"></a>

A função PG\$1GET\$1COLS retorna uma linha para cada coluna em uma definição de tabela ou de exibição. A linha contém uma lista, separada por vírgulas, com nome do esquema, nome do relacionamento, nome da coluna, tipo de dados e número da coluna. A formatação do resultado do SQL depende do cliente SQL utilizado.

## Exemplos
<a name="PG_GET_COLS-example"></a>

Os exemplos a seguir exibem resultados de uma visualização denominada `SALES_VW` no esquema `public` e uma tabela de tabela denominada `sales` no esquema `mytickit1` que são criadas pelo usuário no banco de dados conectado `dev`.

O exemplo a seguir exibe os metadados de coluna para uma visualização chamada `SALES_VW`.

```
select pg_get_cols('sales_vw');

pg_get_cols                                                
-----------------------------------------------------------
(public,sales_vw,salesid,integer,1)                        
(public,sales_vw,listid,integer,2)                         
(public,sales_vw,sellerid,integer,3)                       
(public,sales_vw,buyerid,integer,4)                        
(public,sales_vw,eventid,integer,5)                        
(public,sales_vw,dateid,smallint,6)                        
(public,sales_vw,qtysold,smallint,7)                       
(public,sales_vw,pricepaid,"numeric(8,2)",8)               
(public,sales_vw,commission,"numeric(8,2)",9)              
(public,sales_vw,saletime,"timestamp without time zone",10)
```

O exemplo a seguir exibe os metadados de coluna para a visualização `SALES_VW` em formato de tabela.

```
select * from pg_get_cols('sales_vw') 
cols(view_schema name, view_name name, col_name name, col_type varchar, col_num int);

view_schema | view_name | col_name   | col_type                    | col_num
------------+-----------+------------+-----------------------------+--------
public      | sales_vw  | salesid    | integer                     |       1
public      | sales_vw  | listid     | integer                     |       2
public      | sales_vw  | sellerid   | integer                     |       3
public      | sales_vw  | buyerid    | integer                     |       4
public      | sales_vw  | eventid    | integer                     |       5
public      | sales_vw  | dateid     | smallint                    |       6
public      | sales_vw  | qtysold    | smallint                    |       7
public      | sales_vw  | pricepaid  | numeric(8,2)                |       8
public      | sales_vw  | commission | numeric(8,2)                |       9
public      | sales_vw  | saletime   | timestamp without time zone |      10
```

O exemplo a seguir exibe os metadados de coluna para a tabela `SALES` no esquema `mytickit1` em formato de tabela.

```
select * from pg_get_cols('"mytickit1"."sales"') 
cols(view_schema name, view_name name, col_name name, col_type varchar, col_num int);

view_schema | view_name | col_name   | col_type                    | col_num
------------+-----------+------------+-----------------------------+--------
mytickit1   | sales     | salesid    | integer                     |       1
mytickit1   | sales     | listid     | integer                     |       2
mytickit1   | sales     | sellerid   | integer                     |       3
mytickit1   | sales     | buyerid    | integer                     |       4
mytickit1   | sales     | eventid    | integer                     |       5
mytickit1   | sales     | dateid     | smallint                    |       6
mytickit1   | sales     | qtysold    | smallint                    |       7
mytickit1   | sales     | pricepaid  | numeric(8,2)                |       8
mytickit1   | sales     | commission | numeric(8,2)                |       9
mytickit1   | sales     | saletime   | timestamp without time zone |      10
```