Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

DbCreate

DBCreate( <cName>, <aStruct>, [cDriver] )

Define uma tabela nova e sua estrutura de campos.

DbCreateAdvPL
01 · VISÃO GERAL

Visão geral

DBCreate recebe nome, estrutura e RDD opcional. A estrutura contém nome, tipo, tamanho e decimais por campo; criar não equivale a abrir um alias. A escolha de driver muda limites e persistência, e a documentação restringe a criação ao servidor. O exemplo prepara uma ação para arquivo novo num diretório de teste existente, sem executá-la. Não usar DBCreate para modificar o dicionário ou substituir tabelas Protheus. EDTRB identifica exclusivamente uma tabela própria de teste, já aberta com a estrutura e os direitos necessários; os exemplos não se destinam a tabelas padrão. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

DBCreate( <cName>, <aStruct>, [cDriver] )

Parâmetros

cName
CaractereObrigatório

Nome novo no servidor.

aStruct
ArrayObrigatório

Campos: nome, tipo, tamanho, decimais.

cDriver
CaractereOpcional

RDD; omitida usa o driver local configurado.

Retorno

Não formalizado na ficha; falhas geram ocorrências de erro, não um retorno lógico presumido.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed328()
    Local aCampos := {{"ED_COD", "C", 10, 0}}
    Local bCriar
    // Caminho de teste no servidor: deve existir e nao conter esse arquivo.
    bCriar := {|| DBCreate("ednova.dbf", aCampos, "DBFCDX")}
Return Nil
Resultado esperado

Ação preparada sem criar arquivo. ED_COD identifica o esquema didático fixo. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Conferir RDD, alias e operações pendentes. Navegação pode efetivar atualizações; preservar contexto conforme o contrato do chamador e tratar erros na rotina completa.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. DbCreate. TDN. Consulta em 2026-10-26.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha