Create Table

Cria uma nova tabela no Snowflake com schema especificado.

Endpoint

POST /storage-explorer/tables

Permissões Requeridas

STORAGE_EXPLORER.WRITE

Request Body

Campo	Tipo	Obrigatório	Descrição
`table_name`	string	Sim	Nome da tabela
`schema_name`	string	Sim	Schema onde a tabela será criada
`columns`	array	Sim	Lista de colunas da tabela
`columns[].name`	string	Sim	Nome da coluna
`columns[].type`	string	Sim	Tipo de dado (VARCHAR, INTEGER, TIMESTAMP, etc.)
`columns[].nullable`	boolean	Não	Se a coluna aceita NULL (padrão: true)
`columns[].primary_key`	boolean	Não	Se a coluna é chave primária
`description`	string	Não	Descrição da tabela

Tipos de Dados Suportados

VARCHAR(n) - String de tamanho variável
INTEGER - Número inteiro
BIGINT - Número inteiro grande
DECIMAL(p,s) - Número decimal
FLOAT - Número de ponto flutuante
TIMESTAMP - Data e hora
DATE - Data
BOOLEAN - Booleano
JSON - JSON/VARIANT

Exemplo de Requisição

curl -X POST "https://maestro.dadosfera.ai/storage-explorer/tables" \
  -H "Authorization: <JWT_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "table_name": "customer_orders",
    "schema_name": "RAW_DATA",
    "description": "Tabela de pedidos de clientes",
    "columns": [
      {
        "name": "order_id",
        "type": "VARCHAR(50)",
        "nullable": false,
        "primary_key": true
      },
      {
        "name": "customer_id",
        "type": "VARCHAR(50)",
        "nullable": false
      },
      {
        "name": "order_date",
        "type": "TIMESTAMP",
        "nullable": false
      },
      {
        "name": "total_amount",
        "type": "DECIMAL(10,2)",
        "nullable": true
      },
      {
        "name": "status",
        "type": "VARCHAR(20)",
        "nullable": false
      }
    ]
  }'

Exemplo de Resposta

Success (201 Created):

{
  "table_id": "tbl_a1b2c3d4e5f6",
  "table_name": "customer_orders",
  "schema_name": "RAW_DATA",
  "full_name": "RAW_DATA.customer_orders",
  "created_at": "2024-01-15T10:30:00Z",
  "columns": [
    {
      "name": "order_id",
      "type": "VARCHAR(50)",
      "nullable": false,
      "primary_key": true
    },
    {
      "name": "customer_id",
      "type": "VARCHAR(50)",
      "nullable": false,
      "primary_key": false
    },
    {
      "name": "order_date",
      "type": "TIMESTAMP",
      "nullable": false,
      "primary_key": false
    },
    {
      "name": "total_amount",
      "type": "DECIMAL(10,2)",
      "nullable": true,
      "primary_key": false
    },
    {
      "name": "status",
      "type": "VARCHAR(20)",
      "nullable": false,
      "primary_key": false
    }
  ],
  "description": "Tabela de pedidos de clientes"
}

Códigos de Status

Código	Descrição
`201`	Tabela criada com sucesso
`400`	Parâmetros inválidos ou nome de tabela inválido
`401`	Não autenticado
`403`	Sem permissão STORAGE_EXPLORER.WRITE
`409`	Tabela já existe
`500`	Erro ao criar tabela no Snowflake