ColumnProxy Classe

Proxy fluente para a criação de expressões de filtro OData de um nome de coluna.

Retornado por col. As sobrecargas e os métodos do operador produzem FilterExpression instâncias que podem ser passadas para QueryBuilder.where().

Exemplo:


   from PowerPlatform.Dataverse.models.filters import col

   expr = col("statecode") == 0               # equality
   expr = col("revenue") > 1_000_000          # comparison
   expr = col("name").like("Contoso%")        # startswith
   expr = col("name").is_null()               # null check
   expr = col("statecode").in_([0, 1])        # in

Construtor

ColumnProxy(name: str)

Parâmetros

Nome	Description
name Obrigatório

Métodos

between	Entre o filtro: `(column ge lo and column le hi)`.
contains	Contém filtro: `contains(column, value)`.
endswith	Termina com filtro: `endswith(column, value)`.
in_	No filtro usando `Microsoft.Dynamics.CRM.In`.
is_not_null	Coluna não nula: `column ne null`.
is_null	A coluna é igual a nula: `column eq null`.
like	Filtro de correspondência de padrão compilado para o equivalente OData mais próximo.
not_between	Filtro não entre: `not (column ge lo and column le hi)`.
not_in	Filtro não in usando `Microsoft.Dynamics.CRM.NotIn`.
not_like	Filtro de correspondência de padrão negado; like em seguida, as regras de espelho negam.
startswith	Inicia com o filtro: `startswith(column, value)`.

between

Entre o filtro: (column ge lo and column le hi).

between(lo: Any, hi: Any) -> FilterExpression

Parâmetros

Nome	Description
lo Obrigatório
hi Obrigatório

contains

Contém filtro: contains(column, value).

contains(value: str) -> FilterExpression

Parâmetros

Nome	Description
value Obrigatório

endswith

Termina com filtro: endswith(column, value).

endswith(value: str) -> FilterExpression

Parâmetros

Nome	Description
value Obrigatório

in_

No filtro usando Microsoft.Dynamics.CRM.In.

in_(values: Collection[Any]) -> FilterExpression

Parâmetros

Nome	Description
values Obrigatório	Coleção de valores não vazia.

Exceções

Tipo	Description
ValueError	Se `values` estiver vazio.

is_not_null

Coluna não nula: column ne null.

is_not_null() -> FilterExpression

is_null

A coluna é igual a nula: column eq null.

is_null() -> FilterExpression

like

Filtro de correspondência de padrão compilado para o equivalente OData mais próximo.

like(pattern: str) -> FilterExpression

Parâmetros

Nome	Description
pattern Obrigatório	Cadeia de caracteres de padrão de estilo LIKE.

Exceções

Tipo	Description
ValueError	Se o padrão não puder ser reduzido a uma única função OData.

not_between

Filtro não entre: not (column ge lo and column le hi).

not_between(lo: Any, hi: Any) -> FilterExpression

Parâmetros

Nome	Description
lo Obrigatório
hi Obrigatório

not_in

Filtro não in usando Microsoft.Dynamics.CRM.NotIn.

not_in(values: Collection[Any]) -> FilterExpression

Parâmetros

Nome	Description
values Obrigatório	Coleção de valores não vazia.

Exceções

Tipo	Description
ValueError	Se `values` estiver vazio.

not_like

Filtro de correspondência de padrão negado; like em seguida, as regras de espelho negam.

not_like(pattern: str) -> FilterExpression

Parâmetros

Nome	Description
pattern Obrigatório	Cadeia de caracteres de padrão de estilo LIKE (as mesmas regras que like).

Exceções

Tipo	Description
ValueError	Se o padrão não puder ser reduzido a uma única função OData.

startswith

Inicia com o filtro: startswith(column, value).

startswith(value: str) -> FilterExpression

Parâmetros

Nome	Description
value Obrigatório