GetTableDDL
Retorna informações de tabela no formato de linguagem de definição de dados (DDL) para uma lista de ocorrências de tabela especificadas como uma matriz JSON.
Formato
GetTableDDL ( NomesDeOcorrênciaDeTabela ; ignorarErro )
Parâmetros
NomesDeOcorrênciaDeTabela
- uma expressão de texto para uma matriz JSON das ocorrências de tabela a retornar.
ignorarErro
- se definido como True, retorna informações DDL para as ocorrências de tabela que não causam erro. Se False, retorna informações DDL quando nenhuma ocorrência de tabela causa um erro; caso contrário, retorna "?" para indicar um erro e registra as ocorrências de tabela que causaram o erro no log de chamadas de IA (consulte Etapa de script Definir registro de chamadas de IA).
Tipo de dados retornado
texto
Originada na versão
21.0
Descrição
Esta função retorna uma representação DDL das ocorrências de tabela especificadas no arquivo atual. O DDL consiste em comandos SQL que podem ser usados para definir o esquema do banco de dados (tabelas, campos e relacionamentos).
Notas
-
Juntamente com os nomes de tabelas e campos, o DDL retornado inclui os comentários de campo inseridos na caixa de diálogo Gerenciar banco de dados. Essas informações adicionais sobre cada campo podem ajudar um modelo a fornecer consultas SQL mais úteis.
Exemplo 1
GetTableDDL ( “[\”Reuniões\", \”Tópicos\"]"; True)
retorna o seguinte para um arquivo do FileMaker Pro contendo ocorrências de tabela chamadas Reuniões e Tópicos:
CRIAR TABELA “Reuniões" (
“Título" varchar(255),
“Localização" varchar(255),
“Data" datetime,
“Hora de início" datetime,
“Hora de término" datetime,
“Duração" varchar(255),
“Anotação" varchar(255),
“Chave principal" varchar(255), /*Identificador exclusivo de cada registro nesta tabela*/
“Criado por" varchar(255), /*Nome da conta do usuário que criou cada regitro*/
“Modificado por" varchar(255), /*Nome da conta do usuário que modificou cada registro pela última vez*/
"Carimbo de data/hora de criação" datetime, /*A data e a hora em que cada registro foi criado*/
"Carimbo de data/hora de modificação" datetime, /*A data e a hora em que cada registro foi modificado pela última vez*/
“Incorporação_de_anotação" varbinary(4096),
CHAVE PRINCIPAL (ChavePrincipal)
);
CRIAR TABELA “Tópicos" (
“Assunto" varchar(255),
“Texto" varchar(255),
“Chave externa" varchar(255), /*Identificador exclusivo de cada registro na tabela relacionada*/
“Número de tópicos" int,
“Chave principal" varchar(255), /*Identificador exclusivo de cada registro nesta tabela*/
“Criado por" varchar(255), /*Nome da conta do usuário que criou cada regitro*/
"Modificado por" varchar(255), /*Nome da conta do usuário que modificou cada registro pela última vez*/
"Carimbo de data/hora de criação" datetime, /*A data e a hora em que cada registro foi criado*/
"Carimbo de data/hora de modificação" datetime, /*A data e a hora em que cada registro foi modificado pela última vez*/
CHAVE PRINCIPAL (ChavePrincipal),
CHAVE EXTERNA (ChaveExterna) REFERÊNCIAS Reuniões(ChavePrincipal)
);
Exemplo 2
Ativa o registro de chamadas de IA e, em seguida, para uma matriz de nomes de ocorrência de tabela, verifica se GetTableDDL retorna um erro com o parâmetro ignorarErro
definido como False.
Definir registro de chamadas de IA [ Ativo ; Nome de arquivo: "ai-call.log" ; Texto: Desativado ]
Definir variável [ $tableDDL ; Valor:
GetTableDDL ( JSONMakeArray ( “Reuniões,Funcionários,Informações de contato" ; "," ; JSONString ) ;
False ) ]
If [ $tableDDL = "?" ]
Mostrar caixa de diálogo personalizada [ "Ocorreu um erro. Veja ai-call.log na pasta Documentos." ]
Else
Mostrar caixa de diálogo personalizada [ $tableDDL ]
End If