Editar expressões expression
A edição de uma expressão envolve a inserção manual de condições para formar uma regra. Esse modo permite usar funções avançadas, que permitem manipular os valores usados para realizar consultas específicas, como manipular datas, cadeias de caracteres, campos numéricos, classificação etc.
Trabalhar com o editor de expressão edit
O editor de expressão está disponível pelo botão Editar expressão do modelador de consulta, disponível para os campos Atributo e Valor ao configurar uma condição personalizada.
O editor de expressão fornece:
- Um campo de entrada (1) no qual a expressão é definida.
- A lista de campos (2) disponíveis que podem ser usados na expressão e que correspondem ao esquema, também conhecido como targeting dimension, da consulta.
- Funções auxiliares (3), ordenadas por categoria.
Para editar a expressão, insira uma expressão diretamente no campo de entrada. Para adicionar um campo ou uma função auxiliar, coloque o cursor na expressão à qual deseja adicionar o campo e clique no botão +.
Quando a expressão estiver pronta, clique no botão Confirmar. A expressão é exibida no campo selecionado. Para editá-lo, abra o editor de expressão e faça as alterações desejadas.
O exemplo abaixo mostra uma expressão configurada para o campo Value. Para editá-lo, é necessário abrir o editor de expressão usando o botão Editar expressão.
Funções de ajuda
A ferramenta de edição de consultas permite usar funções avançadas para fazer filtragens complexas, dependendo dos resultados desejados e dos tipos de dados manipulados. Os recursos abaixo estão disponíveis.
Data
As funções de data são usadas para manipular valores de data ou hora.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 22-row-4 23-row-4 24-row-4 25-row-4 26-row-4 27-row-4 28-row-4 29-row-4 30-row-4 31-row-4 32-row-4 33-row-4 34-row-4 35-row-4 36-row-4 37-row-4 38-row-4 39-row-4 40-row-4 41-row-4 | |||
|---|---|---|---|
| Nome | Descrição | Sintaxe | Exemplo |
| AddYears | Adiciona o número especificado de anos ao datetime fornecido. | AddYears(<DATETIME>, <NUMBER>) | AddYears("2019-12-25 15:30:00", 3) |
| AddMonths | Adiciona o número especificado de meses ao datetime fornecido. | AddMonths(<DATETIME>, <NUMBER>) | AddMonths("2019-12-25 15:30:00", 6) |
| AddDays | Adiciona o número especificado de dias ao datetime fornecido. | AddDays(<DATETIME>, <NUMBER>) | AddDays("2019-12-25 15:30:00", 10) |
| AddHours | Adiciona o número especificado de horas ao datetime fornecido. | AddHours(<DATETIME>, <NUMBER>) | AddHours("2019-12-25 15:30:00", 3) |
| AddMinutes | Adiciona o número especificado de minutos ao datetime fornecido. | AddMinutes(<DATETIME>, <NUMBER>) | AddMinutes("2019-12-25 15:30:00", 32) |
| AddSeconds | Adiciona o número especificado de segundos ao datetime fornecido. | AddSeconds(<DATETIME>, <NUMBER>) | AddSeconds("2019-12-25 15:30:00", 37) |
| SubYears | Subtrai o número de anos especificado para o datetime fornecido. | SubYears(<DATETIME>, <NUMBER>) | SubYears("2019-12-25 15:30:00", 3) |
| SubMonths | Subtrai o número de meses especificado para o datetime fornecido. | SubMonths(<DATETIME>, <NUMBER>) | SubMonths("2019-12-25 15:30:00", 6) |
| SubDays | Subtrai o número de dias especificado para a data e hora fornecida. | SubDays(<DATETIME>, <NUMBER>) | SubDays("2019-12-25 15:30:00", 10) |
| SubHours | Subtrai o número de horas especificado para o datetime fornecido. | SubHours(<DATETIME>, <NUMBER>) | SubHours("2019-12-25 15:30:00", 3) |
| SubMinutes | Subtrai o número especificado de minutos para o datetime fornecido. | SubMinutes(<DATETIME>, <NUMBER>) | SubMinutes("2019-12-25 15:30:00", 32) |
| SubSeconds | Subtrai o número especificado de segundos para o datetime fornecido. | SubSeconds(<DATETIME>, <NUMBER>) | SubSeconds("2019-12-25 15:30:00", 37) |
| Year | Extrai o ano do objeto datetime fornecido. | Year(<DATETIME>) | Year("12-15-2019 15:30:00") |
| Month | Extrai o mês do objeto datetime fornecido. | Month(<DATETIME>) | Month("12-15-2019 15:30:00") |
| Day | Extrai o dia do objeto datetime fornecido. | Day(<DATETIME>) | Day("12-15-2019 15:30:00") |
| DayOfYear | Extrai o dia do ano do objeto datetime fornecido. Por exemplo, se o datetime fornecido for 2 de fevereiro, ele retornará 33. | DayOfYear(<DATETIME>) | DayOfYear("12-15-2019 15:30:00") |
| WeekDay | Extrai o dia da semana do objeto datetime fornecido, como um número de 0 a 6, com 0 representando domingo. | Year(<DATETIME>) | Year("12-15-2019 15:30:00") |
| Hour | Extrai o valor de hora do objeto datetime fornecido. | Year(<DATETIME>) | Year("12-15-2019 15:30:00") |
| Minute | Extrai o valor de minuto do objeto datetime fornecido. | Year(<DATETIME>) | Year("12-15-2019 15:30:00") |
| Second | Extrai o segundo valor do objeto datetime fornecido. | Year(<DATETIME>) | Year("12-15-2019 15:30:00") |
| YearsDiff | Localiza a diferença entre os datetimes fornecidos, com uma granularidade de anos. | YearsDiff(<DATETIME>, <DATETIME>) | YearsDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| MonthsDiff | Localiza a diferença entre os datetimes fornecidos, com uma granularidade de meses. | MonthsDiff(<DATETIME>, <DATETIME>) | MonthsDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| DaysDiff | Localiza a diferença entre os datetimes fornecidos, com uma granularidade de dias. | DaysDiff(<DATETIME>, <DATETIME>) | DaysDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| HoursDiff | Localiza a diferença entre os datetimes fornecidos, com uma granularidade de horas. | HoursDiff(<DATETIME>, <DATETIME>) | HoursDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| MinutesDiff | Localiza a diferença entre os datetimes fornecidos, com uma granularidade de minutos. | MinutesDiff(<DATETIME>, <DATETIME>) | MinutesDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| SecondsDiff | Localiza a diferença entre os datetimes fornecidos, com uma granularidade de segundos. | SecondsDiff(<DATETIME>, <DATETIME>) | SecondsDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| YearsOld | Encontra a diferença entre o datetime fornecido e o presente, com uma granularidade de anos. | YearsOld(<DATETIME>) | YearsOld("2019-12-25 15:30:00") |
| MonthsOld | Localiza a diferença entre o datetime fornecido e o presente, com uma granularidade de meses. | MonthsOld(<DATETIME>) | MonthsOld("2019-12-25 15:30:00") |
| DaysOld | Localiza a diferença entre o datetime fornecido e o presente, com uma granularidade de dias. | DaysOld(<DATETIME>) | DaysOld("2019-12-25 15:30:00") |
| GetDate | Obter a data atual do servidor. | GetDate() | GetDate() |
| DateOnly | Corta a data e hora somente para o ano, mês e dia. | DateOnly(<DATETIME>) | DateOnly("2019-12-25 15:30:00") |
| ToDate | Converte o campo em um campo de data. | ToDate(<DATETIME>) | ToDate("2019-12-25 15:30:00") |
| ToDateTime | Converte o campo em um campo de data e hora. | ToDateTime(<DATE>) | ToDateTime("2019-12-25 15:30:00") |
| ToTimestamp | Converte o campo em um campo de carimbo de data e hora. | ToTimestamp(<DATETIME>) | ToTimestamp("2019-12-25 15:30:00") |
| Oldest | Retorna a data mais antiga entre os dois fornecidos. | Oldest(<DATETIME>, <DATETIME>) | Oldest("2015-02-13 11:59:59", "2016-04-13 19:28:14") |
| TruncDate | Corta o datetime para a unidade mais próxima, com base no valor numérico fornecido. Se o valor numérico for igual a 60, ele será truncado no minuto mais próximo. Se o valor numérico for igual a 3600, ele será truncado na hora mais próxima. Se o valor numérico for igual a 86400, ele será truncado no dia mais próximo. Caso contrário, ele será truncado no segundo mais próximo. | TruncDate(<DATETIME>, <NUMBER>) | TruncDate("13/04/2016 19:28:14", 3600) |
| TruncDateTZ | Corta o datetime para a unidade mais próxima, com base no valor numérico fornecido, e define o datetime para o fuso horário especificado. Se o valor numérico for igual a 60, ele será truncado no minuto mais próximo. Se o valor numérico for igual a 3600, ele será truncado na hora mais próxima. Se o valor numérico for igual a 86400, ele será truncado no dia mais próximo. | TruncDateTZ(<DATETIME>, <NUMBER>, <TIMEZONE>) | TruncDateTZ("2016-04-13 19:28:14", 3600, "América/Los_Angeles") |
| TruncTime | Define o datetime para 1º de janeiro de 2000 e arredonda o restante do datetime para a unidade mais próxima, com base no valor numérico fornecido. Se o valor numérico for igual a 60, ele será truncado para o minuto mais próximo. Se o valor numérico for igual a 3600, ele será truncado na hora mais próxima. | TruncTime(<DATETIME>, <NUMBER>) | TruncTime("13/04/2016 19:28:14", 3600) |
| TruncQuarter | Corta o datetime para a primeira data do trimestre mais próximo. | TruncQuarter(<DATETIME>) | TruncQuarter("13/04/2016 19:28:14") |
| TruncYear | Corta o datetime para a primeira data no ano mais próximo. | TruncYear(<DATETIME>) | TruncYear("13/04/2016 19:28:14") |
| TruncWeek | Corta o datetime para o domingo da semana mais próxima. | TruncWeek(<DATETIME>) | TruncWeek("13/04/2016 19:28:14") |
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 22-row-4 23-row-4 24-row-4 25-row-4 26-row-4 27-row-4 28-row-4 29-row-4 30-row-4 31-row-4 32-row-4 33-row-4 34-row-4 35-row-4 36-row-4 37-row-4 38-row-4 39-row-4 40-row-4 41-row-4 | |||
|---|---|---|---|
| Nome | Descrição | Sintaxe | Exemplo |
| AddYears | Adiciona o número especificado de anos ao datetime fornecido. | AddYears(<DATETIME>, <NUMBER>) | AddYears("2019-12-25 15:30:00", 3) |
| AddMonths | Adiciona o número especificado de meses ao datetime fornecido. | AddMonths(<DATETIME>, <NUMBER>) | AddMonths("2019-12-25 15:30:00", 6) |
| AddDays | Adiciona o número especificado de dias ao datetime fornecido. | AddDays(<DATETIME>, <NUMBER>) | AddDays("2019-12-25 15:30:00", 10) |
| AddHours | Adiciona o número especificado de horas ao datetime fornecido. | AddHours(<DATETIME>, <NUMBER>) | AddHours("2019-12-25 15:30:00", 3) |
| AddMinutes | Adiciona o número especificado de minutos ao datetime fornecido. | AddMinutes(<DATETIME>, <NUMBER>) | AddMinutes("2019-12-25 15:30:00", 32) |
| AddSeconds | Adiciona o número especificado de segundos ao datetime fornecido. | AddSeconds(<DATETIME>, <NUMBER>) | AddSeconds("2019-12-25 15:30:00", 37) |
| SubYears | Subtrai o número de anos especificado para o datetime fornecido. | SubYears(<DATETIME>, <NUMBER>) | SubYears("2019-12-25 15:30:00", 3) |
| SubMonths | Subtrai o número de meses especificado para o datetime fornecido. | SubMonths(<DATETIME>, <NUMBER>) | SubMonths("2019-12-25 15:30:00", 6) |
| SubDays | Subtrai o número de dias especificado para a data e hora fornecida. | SubDays(<DATETIME>, <NUMBER>) | SubDays("2019-12-25 15:30:00", 10) |
| SubHours | Subtrai o número de horas especificado para o datetime fornecido. | SubHours(<DATETIME>, <NUMBER>) | SubHours("2019-12-25 15:30:00", 3) |
| SubMinutes | Subtrai o número especificado de minutos para o datetime fornecido. | SubMinutes(<DATETIME>, <NUMBER>) | SubMinutes("2019-12-25 15:30:00", 32) |
| SubSeconds | AdSubtracta o número especificado de segundos para o datetime fornecido. | SubSeconds(<DATETIME>, <NUMBER>) | SubSeconds("2019-12-25 15:30:00", 37) |
| Year | Extrai o ano do objeto datetime fornecido. | Year(<DATETIME>) | Year("12-15-2019 15:30:00") |
| Month | Extrai o mês do objeto datetime fornecido. | Month(<DATETIME>) | Month("12-15-2019 15:30:00") |
| Day | Extrai o dia do objeto datetime fornecido. | Day(<DATETIME>) | Day("12-15-2019 15:30:00") |
| DayOfYear | Extrai o dia do ano do objeto datetime fornecido. Por exemplo, se o datetime fornecido for 2 de fevereiro, ele retornará 33. | DayOfYear(<DATETIME>) | DayOfYear("12-15-2019 15:30:00") |
| WeekDay | Extrai o dia da semana do objeto datetime fornecido, como um número de 1 a 7, com 1 representando domingo. | Year(<DATETIME>) | Year("12-15-2019 15:30:00") |
| Hour | Extrai o valor de hora do objeto datetime fornecido. | Year(<DATETIME>) | Year("12-15-2019 15:30:00") |
| Minute | Extrai o valor de minuto do objeto datetime fornecido. | Year(<DATETIME>) | Year("12-15-2019 15:30:00") |
| Second | Extrai o segundo valor do objeto datetime fornecido. | Year(<DATETIME>) | Year("12-15-2019 15:30:00") |
| YearsDiff | Localiza a diferença entre os datetimes fornecidos, com uma granularidade de anos. | YearsDiff(<DATETIME>, <DATETIME>) | YearsDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| MonthsDiff | Localiza a diferença entre os datetimes fornecidos, com uma granularidade de meses. | MonthsDiff(<DATETIME>, <DATETIME>) | MonthsDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| DaysDiff | Localiza a diferença entre os datetimes fornecidos, com uma granularidade de dias. | DaysDiff(<DATETIME>, <DATETIME>) | DaysDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| HoursDiff | Localiza a diferença entre os datetimes fornecidos, com uma granularidade de horas. | HoursDiff(<DATETIME>, <DATETIME>) | HoursDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| MinutesDiff | Localiza a diferença entre os datetimes fornecidos, com uma granularidade de minutos. | MinutesDiff(<DATETIME>, <DATETIME>) | MinutesDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| SecondsDiff | Localiza a diferença entre os datetimes fornecidos, com uma granularidade de segundos. | SecondsDiff(<DATETIME>, <DATETIME>) | SecondsDiff("2019-12-25 15:30:00", "2018-10-14 18:35:27") |
| MonthsOld | Localiza a diferença entre o datetime fornecido e o presente, com uma granularidade de meses. | MonthsOld(<DATETIME>) | MonthsOld("2019-12-25 15:30:00") |
| DaysOld | Localiza a diferença entre o datetime fornecido e o presente, com uma granularidade de dias. | DaysOld(<DATETIME>) | DaysOld("2019-12-25 15:30:00") |
| GetDate | Obter a data atual do servidor. | GetDate() | GetDate() |
| DateOnly | Corta a data e hora somente para o ano, mês e dia. | DateOnly(<DATETIME>) | DateOnly("2019-12-25 15:30:00") |
| ToDate | Converte o campo em um campo de data. | ToDate(<DATETIME>) | ToDate("2019-12-25 15:30:00") |
| ToDateTime | Converte o campo em um campo de data e hora. | ToDateTime(<DATE>) | ToDateTime("2019-12-25 15:30:00") |
| ToTimestamp | Converte o campo em um campo de carimbo de data e hora. | ToTimestamp(<DATETIME>) | ToTimestamp("2019-12-25 15:30:00") |
| Oldest | Retorna a data mais antiga entre os dois fornecidos. | Oldest(<DATETIME>, <DATETIME>) | Oldest("2015-02-13 11:59:59", "2016-04-13 19:28:14") |
| TruncDate | Corta o datetime para a unidade mais próxima, com base no valor numérico fornecido. Se o valor numérico for igual a 60, ele será truncado no minuto mais próximo. Se o valor numérico for igual a 3600, ele será truncado na hora mais próxima. Se o valor numérico for igual a 86400, ele será truncado no dia mais próximo. Caso contrário, ele será truncado no segundo mais próximo. | TruncDate(<DATETIME>, <NUMBER>) | TruncDate("13/04/2016 19:28:14", 3600) |
| TruncDateTZ | Corta o datetime para a unidade mais próxima, com base no valor numérico fornecido, e define o datetime para o fuso horário especificado. Se o valor numérico for igual a 60, ele será truncado no minuto mais próximo. Se o valor numérico for igual a 3600, ele será truncado na hora mais próxima. Se o valor numérico for igual a 86400, ele será truncado no dia mais próximo. | TruncDateTZ(<DATETIME>, <NUMBER>, <TIMEZONE>) | TruncDateTZ("2016-04-13 19:28:14", 3600, "América/Los_Angeles") |
| TruncTime | Define o datetime para 1º de janeiro de 2000 e arredonda o restante do datetime para a unidade mais próxima, com base no valor numérico fornecido. Se o valor numérico for igual a 60, ele será truncado para o minuto mais próximo. Se o valor numérico for igual a 3600, ele será truncado na hora mais próxima. | TruncTime(<DATETIME>, <NUMBER>) | TruncTime("13/04/2016 19:28:14", 3600) |
| TruncQuarter | Corta o datetime para a primeira data do trimestre mais próximo. | TruncQuarter(<DATETIME>) | TruncQuarter("13/04/2016 19:28:14") |
| TruncYear | Corta o datetime para a primeira data no ano mais próximo. | TruncYear(<DATETIME>) | TruncYear("13/04/2016 19:28:14") |
| TruncWeek | Corta o datetime para o domingo da semana mais próxima. | TruncWeek(<DATETIME>) | TruncWeek("13/04/2016 19:28:14") |
| ConvertNTZ | Converte um carimbo de data e hora sem fuso horário em um carimbo de data e hora com fuso horário. O fuso horário anexado será o fuso horário da conta externa. | ConvertNTZ(<DATETIME>) | ConvertNTZ("24/06/2024 14:43:49") |
Geomarketing
As funções de geomarketing são usadas para manipular valores geográficos.
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Nome | Descrição | Sintaxe | Exemplo |
| Distance | Retorna a distância entre dois pontos definidos por sua longitude e latitude em graus, como um duplo. | Distance(<NUMBER>, <NUMBER>, <NUMBER>, <NUMBER>) | Distance(40,345, 39,2345, -35,5834, 34,599) |
| table 0-row-4 1-row-4 | |||
|---|---|---|---|
| Nome | Descrição | Sintaxe | Exemplo |
| Distance | Retorna a distância entre dois pontos definidos por sua longitude e latitude em graus, como um duplo. | Distance(<NUMBER>, <NUMBER>, <NUMBER>, <NUMBER>) | Distance(40,345, 39,2345, -35,5834, 34,599) |
Numérico
As funções numéricas são usadas para converter textos em números.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 | |||
|---|---|---|---|
| Nome | Descrição | Sintaxe | Exemplo |
| Mod | Retorna o restante do primeiro número dividido pelo segundo número. | Mod(<NUMBER>, <NUMBER>) | Mod (3, 2) |
| Percent | Calcula a porcentagem do primeiro número em relação ao segundo número. | Percent(<NUMBER>, <NUMBER>) | Percentual(1, 2) |
| Random | Retorna um número aleatório entre 0 (inclusivo) e 1 (exclusivo). | Random() | Aleatório () |
| Round | Retorna o número fornecido para a casa decimal solicitada mais próxima. | Round(<NÚMERO>, <NÚMERO>) | Round(4.5394, 2) |
| ToDouble | Converte o número fornecido em um duplo. | ToDouble(<NUMBER>) | ToDouble(5) |
| ToInteger | Converte o número fornecido em um inteiro. | ToInteger(<NUMBER>) | ToInteger(45) |
| ToInt64 | Converte o número fornecido em um inteiro de 64 bits. | ToInt64(<NUMBER>) | ToInt64(493) |
| Trunc | Trunca o número fornecido para o número solicitado de casas decimais. | Trunc(<NUMBER>, <NUMBER>) | Trunc(36.9348934, 3) |
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 | |||
|---|---|---|---|
| Nome | Descrição | Sintaxe | Exemplo |
| Mod | Retorna o restante do primeiro número dividido pelo segundo número. | Mod(<NUMBER>, <NUMBER>) | Mod (3, 2) |
| Percent | Calcula a porcentagem do primeiro número em relação ao segundo número. | Percent(<NUMBER>, <NUMBER>) | Percentual(1, 2) |
| Random | Retorna um número aleatório entre 0 (inclusivo) e 1 (exclusivo). | Random() | Aleatório () |
| ToDouble | Converte o número fornecido em um duplo. | ToDouble(<NUMBER>) | ToDouble(5) |
| ToInteger | Converte o número fornecido em um inteiro. | ToInteger(<NUMBER>) | ToInteger(45) |
| ToInt64 | Converte o número fornecido em um inteiro de 64 bits. | ToInt64(<NUMBER>) | ToInt64(493) |
| Trunc | Trunca o número fornecido para o número solicitado de casas decimais. | Trunc(<NUMBER>, <NUMBER>) | Trunc(36.9348934, 3) |
Outros
Esta tabela contém as demais funções disponíveis.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 | |||
|---|---|---|---|
| Nome | Descrição | Sintaxe | Exemplo |
| Case | Retorna o primeiro valor se a expressão for verdadeira. Caso contrário, retorna o segundo valor. | Case(When(<EXPRESSÃO> <VALOR>), Else(<VALOR>)) | Case(Quando(a > b, "sim"), Else("não")) |
| When | Usado como parte da função Case. Usado para verificar a expressão em maiúsculas e minúsculas. | When(<EXPRESSÃO> <VALOR>) | Quando(a > b, "sim") |
| Else | Usado como parte da função Case. Usado para escolher a outra opção, se a expressão When for falsa. | Else(<VALOR>) | Senão ("não") |
| Coalesce | Retorna o primeiro valor não nulo. | Coalesce(<VALUE>, <VALUE>) | União ("", "string") |
| Decode | Retorna a primeira opção se os valores forem iguais. Retorna a segunda opção se os valores não forem iguais. | Decode(<VALUE>, <VALUE>, <VALUE>, <VALUE>) | Decode( 1, 2, "verdadeiro", "falso") |
| GetEmailDomain | Extrai o domínio do endereço de email fornecido. | GetEmailDomain(<CADEIA DE CARACTERES>) | GetEmailDomain("sample@example.com") |
| Iif | Retorna a primeira opção se a condição for verdadeira e retorna a segunda opção se a condição for falsa. | Iif(<CONDIÇÃO>, <VALOR>, <VALOR>) | Iif(10 < 20, "true", "false") |
| IsEmptyString | Retorna a primeira opção se a cadeira de caracteres estiver vazia. Caso contrário, retorna a segunda opção. | IsEmptyString( <CADEIA DE CARACTERES> ,<VALOR>, <VALOR>) | IsEmptyString("string", "sim", "não") |
| NewUUID | Gera um novo UUID exclusivo. | NewUUID() | NewUUID() |
| NoNull | Retorna a cadeia de caracteres fornecida, se não estiver vazia, e retorna uma cadeia de caracteres vazia, se a cadeia de caracteres fornecida estiver vazia. | NoNull(<STRING>) | NoNull("teste") |
| IsBitSet | Executa um bit a bit e (&) nos números fornecidos. Isso permite verificar se o bit dentro do primeiro parâmetro está definido na posição fornecida no segundo parâmetro. | IsBitSet(<NUMBER>, <NUMBER>) | IsBitSet(5, 3) |
| ClearBit | Isso permite que você limpe o bit dentro do primeiro parâmetro na posição fornecida no segundo parâmetro. | ClearBit(<NUMBER>, <NUMBER>) | |
| SetBit | Executa um bit a bit ou (|) nos números fornecidos. Isso permite que você defina o bit dentro do primeiro parâmetro é definido na posição fornecida no segundo parâmetro. | SetBit(<NUMBER>, <NUMBER>) | SetBit(5, 3) |
| RowId | Retorna o número da linha. | RowId() | RowId() |
| ToBoolean | Converte o valor em um booleano. | ToBoolean(<VALUE>) | ToBoolean(a=b) |
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 | |||
|---|---|---|---|
| Nome | Descrição | Sintaxe | Exemplo |
| Case | Retorna o primeiro valor se a expressão for verdadeira. Caso contrário, retorna o segundo valor. | Case(When(<EXPRESSÃO> <VALOR>), Else(<VALOR>)) | Case(Quando(a > b, "sim"), Else("não")) |
| When | Usado como parte da função Case. Usado para verificar a expressão em maiúsculas e minúsculas. | When(<EXPRESSÃO> <VALOR>) | Quando(a > b, "sim") |
| Else | Usado como parte da função Case. Usado para escolher a outra opção, se a expressão When for falsa. | Else(<VALOR>) | Senão ("não") |
| GetEmailDomain | Extrai o domínio do endereço de email fornecido. | GetEmailDomain(<CADEIA DE CARACTERES>) | GetEmailDomain("sample@example.com") |
| Iif | Retorna a primeira opção se a condição for verdadeira e retorna a segunda opção se a condição for falsa. | Iif(<CONDIÇÃO>, <VALOR>, <VALOR>) | Iif(10 < 20, "true", "false") |
| IsEmptyString | Retorna a primeira opção se a cadeira de caracteres estiver vazia. Caso contrário, retorna a segunda opção. | IsEmptyString( <CADEIA DE CARACTERES> ,<VALOR>, <VALOR>) | IsEmptyString("string", "sim", "não") |
| ToBoolean | Retorna 1 se o valor for verdadeiro. Retorna 0 se o valor for falso. | ToBoolean(<VALUE>) | ToBoolean(a=b) |
| ToBooleanType | Converte o valor em um booleano. | ToBooleanType(<VALUE>) | ToBooleanType(a=b) |
| IsBitSet | Executa um bit a bit e (&) nos números fornecidos. Isso permite verificar se o bit dentro do primeiro parâmetro está definido na posição fornecida no segundo parâmetro. | IsBitSet(<NUMBER>, <NUMBER>) | IsBitSet(5, 3) |
| ClearBit | Isso permite que você limpe o bit dentro do primeiro parâmetro na posição fornecida no segundo parâmetro. | ClearBit(<NUMBER>, <NUMBER>) | |
| SetBit | Executa um bit a bit ou (|) nos números fornecidos. Isso permite que você defina o bit dentro do primeiro parâmetro é definido na posição fornecida no segundo parâmetro. | SetBit(<NUMBER>, <NUMBER>) | SetBit(5, 3) |
| RowId | Retorna o número da linha. | RowId() | RowId() |
| NewUUID | Gera um novo UUID exclusivo. | NewUUID() | NewUUID() |
| NoNull | Retorna a cadeia de caracteres fornecida, se não estiver vazia, e retorna uma cadeia de caracteres vazia, se a cadeia de caracteres fornecida estiver vazia. | NoNull(<STRING>) | NoNull("teste") |
| AESEncrypt | Criptografa a string fornecida com o tipo de criptografia AES. | AESEncrypt() | AESEncrypt("Olá") |
| ConstrutorDeObjetos | Cria um objeto com base nos pares de chave/valor fornecidos. | ObjectConstruct(<STRING>, <STRING>) | ObjectConstruct("chave", "valor") |
String
As funções de string são usadas para manipular um conjunto de strings.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 | |||
|---|---|---|---|
| Nome | Descrição | Sintaxe | Exemplo |
| AllNonNull2 | Pega duas sequências de caracteres e verifica se todas elas não são nulas e não estão vazias. | AllNonNull2(<STRING>, <STRING>) | AllNonNull2("", "string2") |
| AllNonNull3 | Pega três strings e verifica se todas elas não são nulas nem estão vazias | AllNonNull3(<STRING>, <STRING>, <STRING>) | AllNonNull3("", "um", "três") |
| Ascii | Pega uma string e retorna o resultado . | Ascii(<CADEIA DE CARACTERES>) | Ascii ("foo") |
| Char | Obtém uma matriz de pontos de código Unicode e retorna a cadeia de caracteres resultante. | Char(<ARRAY>) | Char([65, 68, 79, 66, 69]) |
| Charindex | Localiza a primeira ocorrência da substring especificada dentro da string principal. | Charindex(<STRING>, <SUBSTRING>) | Charindex ("bar@example.com", "@") |
| dataLength | Retorna o número de bytes na string. | dataLength(<STRING>) | dataLength("Minha cadeia de caracteres") |
| GetLine | Retorna a linha solicitada da cadeia de caracteres fornecida. | GetLine(<STRING>, <NUMBER>) | GetLine(multilinestring, 5) |
| IfEquals | Pega quatro cadeias de caracteres e retorna a terceira se as duas primeiras forem iguais, e retorna a quarta se as duas primeiras não forem iguais. | IfEquals(<STRING>, <STRING>, <STRING>, <STRING>) | IfEquals("a", "a", "yes", "no") |
| IsMemoNull | Retorna 1 se a string for nula, caso contrário, retorna 0. | IsMemoNull(<STRING>) | IsMemoNull("Olá") |
| JuxtWords | Pega duas cordas e as combina em uma única. Se necessário, os espaços entre as cadeias de caracteres são adicionados. | JuxtWords(<STRING>, <STRING>) | JuxtWords("Olá", "Mundo") |
| JuxtWords3 | Pega três strings e as combina em uma única string. Se necessário, os espaços entre as cadeias de caracteres são adicionados. | JuxtWords3(<STRING>, <STRING>, <STRING>) | JuxtWords3("Olá", "Novo", "Mundo") |
| Left | Pega uma string e retorna os caracteres mais à esquerda, conforme especificado. | Left(<STRING>, <NUMBER>) | Left("Substring", 3) |
| Length | Retorna o comprimento da cadeira de caracteres. | Length(<CADEIA DE CARACTERES>) | Length("MyString") |
| Md5Digest | Converte a string com hash MD5 em sua representação hexadecimal. | Md5Digest(<CADEIA DE CARACTERES>) | Md5Digest("Cadeia De Caracteres") |
| MemoContains | Verifica se a cadeia de caracteres contém a subsequência fornecida. | MemoContains(<STRING>, <STRING>) | MemoContains("string", "str") |
| Right | Pega uma sequência de caracteres e retorna os caracteres mais à direita, conforme especificado. | Right(<STRING>, <NUMBER>) | À Direita ("Substring", 3) |
| Smart | Retorna a cadeira de caracteres com a primeira letra de cada palavra em maiúscula. | Smart(<CADEIA DE CARACTERES>) | Smart("olá mundo") |
| Substring | Pega uma sequência de caracteres e retorna uma parte da sequência fornecida, com base nas posições fornecidas. | Substring(<STRING>, <LEFT_NUMBER>, RIGHT_NUMBER>) | Substring("Substring", 3, 5) |
| Sha256Digest | Converte a string com hash SHA256 em sua representação hexadecimal. | Sha256Digest(<CADEIA DE CARACTERES>) | Sha256Digest("string") |
| Sha512Digest | Converte a string com hash SHA512 em sua representação hexadecimal. | Sha512Digest(<CADEIA DE CARACTERES>) | Sha512Digest("string") |
| ToString | Retorna o valor como uma string. | ToString(<VALOR>) | ToString(123) |
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 | |||
|---|---|---|---|
| Nome | Descrição | Sintaxe | Exemplo |
| AllNonNull2 | Pega duas sequências de caracteres e verifica se todas elas não são nulas e não estão vazias. | AllNonNull2(<STRING>, <STRING>) | AllNonNull2("", "string2") |
| AllNonNull3 | Pega três strings e verifica se todas elas não são nulas nem estão vazias | AllNonNull3(<STRING>, <STRING>, <STRING>) | AllNonNull3("", "um", "três") |
| Char | Obtém uma matriz de pontos de código Unicode e retorna a cadeia de caracteres resultante. | Char(<ARRAY>) | Char([65, 68, 79, 66, 69]) |
| Charindex | Localiza a primeira ocorrência da substring especificada dentro da string principal. | Charindex(<STRING>, <SUBSTRING>) | Charindex ("bar@example.com", "@") |
| dataLength | Retorna o número de bytes na string. | dataLength(<STRING>) | dataLength("Minha cadeia de caracteres") |
| GetLine | Retorna a linha solicitada da cadeia de caracteres fornecida. | GetLine(<STRING>, <NUMBER>) | GetLine(multilinestring, 5) |
| IfEquals | Pega quatro cadeias de caracteres e retorna a terceira se as duas primeiras forem iguais, e retorna a quarta se as duas primeiras não forem iguais. | IfEquals(<STRING>, <STRING>, <STRING>, <STRING>) | IfEquals("a", "a", "yes", "no") |
| IsMemoNull | Retorna 1 se a string for nula, caso contrário, retorna 0. | IsMemoNull(<STRING>) | IsMemoNull("Olá") |
| JuxtWords | Pega duas cordas e as combina em uma única. Se necessário, os espaços entre as cadeias de caracteres são adicionados. | JuxtWords(<STRING>, <STRING>) | JuxtWords("Olá", "Mundo") |
| JuxtWords3 | Pega três strings e as combina em uma única string. Se necessário, os espaços entre as cadeias de caracteres são adicionados. | JuxtWords3(<STRING>, <STRING>, <STRING>) | JuxtWords3("Olá", "Novo", "Mundo") |
| Left | Pega uma string e retorna os caracteres mais à esquerda, conforme especificado. | Left(<STRING>, <NUMBER>) | Left("Substring", 3) |
| Length | Retorna o comprimento da cadeira de caracteres. | Length(<CADEIA DE CARACTERES>) | Length("MyString") |
| Linha | Retorna a linha numerada especificada da cadeia de caracteres. | Line(<STRING>, <NUMBER>) | Linha (multilinestring, 5) |
| Md5Digest | Converte a string com hash MD5 em sua representação hexadecimal. | Md5Digest(<CADEIA DE CARACTERES>) | Md5Digest("Cadeia De Caracteres") |
| Replace | Pega uma sequência de caracteres e substitui todas as instâncias da subsequência por uma subsequência de substituição. | Replace(<STRING>, <STRING>, <STRING>) | Replace("Capitão Steve", "Capitão", "Engenheiro") |
| Right | Pega uma sequência de caracteres e retorna os caracteres mais à direita, conforme especificado. | Right(<STRING>, <NUMBER>) | À Direita ("Substring", 3) |
| Sha256Digest | Converte a string com hash SHA256 em sua representação hexadecimal. | Sha256Digest(<CADEIA DE CARACTERES>) | Sha256Digest("string") |
| Sha512Digest | Converte a string com hash SHA512 em sua representação hexadecimal. | Sha512Digest(<CADEIA DE CARACTERES>) | Sha512Digest("string") |
| Smart | Retorna a cadeira de caracteres com a primeira letra de cada palavra em maiúscula. | Smart(<CADEIA DE CARACTERES>) | Smart("olá mundo") |
| ToString | Retorna o valor como uma string. | ToString(<VALOR>) | ToString(123) |
Janela
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Nome | Descrição | Sintaxe | Exemplo |
| RowNum | Retorna uma sequência de linhas com base na partição da tabela e na sequência de classificação. | RowNum(PartitionBy(<EXPRESSION>), OrderBy(<EXPRESSION>)) | RowNum(PartitionBy(division), OrderBy(time)) |
| PartitionBy | Separa as linhas de entrada em diferentes partições, com base na expressão fornecida. | PartitionBy(<EXPRESSION>) | PartitionBy(divisão) |
| OrderBy | Classifica o resultado da partição. | OrderBy(<EXPRESSION>) | OrderBy(age) |
| Desc | Permite que o OrderBy seja classificado por ordem decrescente, em vez de crescente. | Desc(OrderBy(<EXPRESSION>)) | Desc(OrderBy(age)) |
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 | |||
|---|---|---|---|
| Nome | Descrição | Sintaxe | Exemplo |
| RowNum | Retorna uma sequência de linhas com base na partição da tabela e na sequência de classificação. | RowNum(PartitionBy(<EXPRESSION>), OrderBy(<EXPRESSION>)) | RowNum(PartitionBy(division), OrderBy(time)) |
| PartitionBy | Separa as linhas de entrada em diferentes partições, com base na expressão fornecida. | PartitionBy(<EXPRESSION>) | PartitionBy(divisão) |
| OrderBy | Classifica o resultado da partição. | OrderBy(<EXPRESSION>) | OrderBy(age) |
| Desc | Permite que o OrderBy seja classificado por ordem decrescente, em vez de crescente. | Desc(OrderBy(<EXPRESSION>)) | Desc(OrderBy(age)) |