notIn

notIn avalia se existe uma expressão em uma lista literal. Se a lista não contiver a expressão, notIn retornará true, caso contrário, retornará false. notIn diferencia maiúsculas de minúsculas para entradas do tipo string.

notIn aceita dois tipos de lista literal, uma é a lista inserida manualmente e a outra é um parâmetro de vários valores.

Sintaxe

Usando uma lista inserida manualmente:

notIn(expression, [literal-1, ...])  

Usando um parâmetro de vários valores:

notIn(expression, $multivalue_parameter)

Argumentos

expressão

A expressão a ser comparada com os elementos na lista literal. Pode ser um nome de campo, como address, um valor literal, como 'Unknown', um parâmetro de valor único ou uma chamada para outra função escalar, desde que essa função não seja uma função agregada ou um cálculo de tabela.

lista literal

(obrigatório) Isso pode ser uma lista inserida manualmente ou um parâmetro de vários valores. Esse argumento aceita até cinco mil elementos. No entanto, em uma consulta direta a uma fonte de dados de terceiros, por exemplo, Oracle ou Teradata, a restrição pode ser menor.

• Lista inserida manualmente: um ou mais valores literais em uma lista a serem comparados com a expressão. A lista deve estar entre colchetes. Todos os literais a serem comparados devem ter o mesmo tipo de dados da expressão.

• Parâmetro de vários valores: um parâmetro de vários valores predefinido transmitido como uma lista literal. O parâmetro de vários valores deve ter o mesmo tipo de dados da expressão.

Tipo de retorno

Booleano:/TRUEFALSE

Exemplo com uma lista inserida manualmente

O exemplo a seguir avalia o campo origin_state_name para valores em uma lista de string. Ao comparar a entrada do tipo de string, notIn aceita apenas a comparação com distinção entre maiúsculas e minúsculas.

notIn(origin_state_name,["Georgia", "Ohio", "Texas"])

A seguir estão os valores de campo especificados.

"Washington"
        "ohio"
        "Texas"

Para esses valores de campo, os valores a seguir são retornados.

true
        true
        false

O terceiro valor de retorno é falso porque somente “Texas” é um dos valores excluídos.

O exemplo a seguir avalia o campo fl_date para valores em uma lista de string. Para corresponder ao tipo, toString é usado para converter o tipo de data ao tipo de string.

notIn(toString(fl_date),["2015-05-14","2015-05-15","2015-05-16"])

Literais e NULL valores são suportados no argumento da expressão para serem comparados com os literais na lista. Os dois exemplos a seguir gerarão uma nova coluna de FALSE valores.

notIn("Washington",["Washington","Ohio"])

notIn(NULL,[NULL,"Ohio"])

Exemplo com parâmetro de vários valores

Digamos que um autor crie um parâmetro de vários valores que contenha uma lista de todos os nomes dos estados. Em seguida, o autor adiciona um controle para permitir que o leitor selecione valores da lista.

Depois, o leitor seleciona três valores, “Georgia”, “Ohio” e “Texas”, no controle da lista suspensa do parâmetro. Nesse caso, a expressão a seguir é equivalente ao primeiro exemplo, em que esses três nomes de estado são passados como a lista literal a ser comparada com o campo original_state_name.

notIn (origin_state_name, ${stateName MultivalueParameter})

Exemplo com ifelse

notIn pode ser aninhado em outras funções como um valor booleano. Um exemplo é que os autores podem avaliar qualquer expressão em uma lista e retornar o valor desejado usando notIn e ifelse. O exemplo a seguir avalia se o dest_state_name de um voo está em uma lista específica de estados dos EUA e retorna diferentes categorias dos estados com base na comparação.

ifelse(notIn(dest_state_name,["Washington", "Oregon","California"]), "notWestCoastUSState", "WestCoastUSState")