cNameCaractereObrigatório
Nome de índice novo, distinto da tabela no TOPCONN.
FUNçãOEm revisão
DbCreateIndex
DBCreateIndex( <cName>, <cExprKey>, [bExprKey], [lUnique] ) --> NilCria um índice para a tabela ou view do contexto.
Visão geral
DBCreateIndex recebe nome e expressão da chave, com bloco e unicidade opcionais. A documentação alerta que um índice de mesmo nome pode ser substituído e que a operação fecha índices, escolhe a nova ordem e reposiciona registros. O bloco deve refletir o valor da chave, não retornar a string que contém a expressão. O arquivo comunitário analisado usa um bloco que devolve cIndice; não o reproduzimos como modelo de chave executável. O fragmento exige índice novo e tabela própria compatível com a RDD. 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)
Sintaxe
DBCreateIndex( <cName>, <cExprKey>, [bExprKey], [lUnique] ) --> NilParâmetros
cExprKeyCaractereObrigatório
Expressão da chave em texto.
bExprKeyBloco de códigoOpcional
Expressão executável equivalente.
lUniqueLógicoOpcional
Controle de índice único; conferir semântica da RDD.
Retorno
Nil; não é um indicador lógico de sucesso.
Exemplo comentado
#Include "Protheus.ch"
User Function Ed329()
// ED_NEWIDX deve estar livre; EDTRB tem campo ED_COD e uso proprio.
If Select("EDTRB") > 0
EDTRB->(DBCreateIndex("ED_NEWIDX", "ED_COD", {|| ED_COD}, .F.))
EndIf
Return NilResultado esperado
Propõe criar o índice e alterar a ordem do contexto de teste; não é operação neutra de consulta. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- 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.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.