Text() força o tratamento da expressão como texto, mesmo que seja possível uma interpretação numérica.
Sintaxe:
Text (expr)
Tipo de dados de retorno: caractere
| Argumento | Descrição |
|---|---|
| expr | Uma expressão a ser tratada como texto. |
| Exemplo | Resultados |
|---|---|
| Text( 1234 ) | Retorna 1234 como uma string. Não há valor numérico. |
| Text( pi( ) ) | Retorna 3.1415926535898 como uma string. Não há valor numérico. |
Exemplo – Fundamentos de Text
Visão geral
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
O script de carregamento contém:
-
Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
-
Os campos a seguir na tabela de dados:
-
ID
-
PostalCode
-
-
Um carregamento anterior que usa a função Text para criar um novo campo chamado PostalCode_Text para garantir que os códigos postais permaneçam como texto e não sejam convertidos em números.
Script de carregamento
Example:
LOAD
ID,
PostalCode,
Text(PostalCode) AS PostalCode_Text;
LOAD * INLINE [
ID, PostalCode
1, 12345
2, 54321
3, 67890
4, 11223
5, 33445
];Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
-
ID
-
PostalCode
-
PostalCode_Text
| ID | PostalCode | PostalCode_Text |
|---|---|---|
| 1 | 12345 | 12345 |
| 2 | 54321 | 54321 |
| 3 | 67890 | 67890 |
| 4 | 11223 | 11223 |
| 5 | 33445 | 33445 |
A saída do carregamento anterior usa a função Text para garantir que todos os valores numéricos sejam tratados como texto. Você pode ver que os valores na coluna PostalCode_Text são processados como texto e aparecem alinhados à esquerda por padrão, enquanto os valores na coluna PostalCode são números e aparecem alinhados à direita por padrão.
Exemplo - Cenário de Text
Visão geral
Um conjunto de dados contém dados de faturas de clientes que são inseridos como valores numéricos, mas você deseja manter esses valores como texto.
Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção.
O script de carregamento contém:
-
Um conjunto de dados que é carregado em uma tabela de dados denominada Example.
-
Os campos a seguir na tabela de dados:
-
InvoiceNumber
-
CustomerName
-
-
Um carregamento anterior que usa a função Text para criar um novo campo nomeado InvoiceNumber_Text para garantir que os números da fatura sejam tratados como texto.
Script de carregamento
Example:
LOAD
InvoiceNumber,
CustomerName,
Text(InvoiceNumber) AS InvoiceNumber_Text;
LOAD * INLINE [
InvoiceNumber, CustomerName
10001, John Doe
10002, Jane Smith
10003, Bob Johnson
10004, Alice Brown
10005, Michael Green
];Resultados
Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:
-
InvoiceNumber
-
CustomerName
-
InvoiceNumber_Text
| InvoiceNumber | CustomerName | InvoiceNumber_Text |
|---|---|---|
| 10001 | John Doe | 10001 |
| 10002 | Jane Smith | 10002 |
| 10003 | Bob Johnson | 10003 |
| 10004 | Alice Brown | 10004 |
| 10005 | Michael Green | 10005 |
Os resultados mostram que os valores numéricos na coluna InvoiceNumber agora foram convertidos em valores de texto na coluna InvoiceNumber_Text e aparecem alinhados à esquerda.