O Guia Definitivo do Yii 1.1

$posts=Post::model()->with(
'author.profile',
'author.posts',
'categories')->together()->findAll();
A consulta acima será executada em um único comando SQL. Sem o método together,
serão necessárias três consultas: uma irá fazer a junção das tabelas Post, User e Profile,
outra irá fazer a junção de User ePost e a última irá fazer a junção de Post, PostCategory
e Category.
Opções de Consultas Relacionais
Nós mencionamos que pode-se especificar algumas opções adicionais na declaração de
um relacionamento. Essas opções, especificadas na forma de pares nome-valor, são
utilizadas para personalizar as consultas relacionais. Elas estão resumidas abaixo:
• select: uma lista de colunas que serão selecionadas nas classes AR relacionadas.
Por padrão, seu valor é '*', que significa todas as colunas. Quando utilizada em
expressões os nomes das colunas devem se identificados com um aliasToken
(apelido para tabela), (por exemplo COUNT(??.name) AS nameCount).
• condition: representa a cláusula WHERE. Não tem nenhum valor por padrão. Note
que, para evitar conflitos entre nomes de colunas iguais, referencias a colunas
precisão ser identificadas por um aliasToken, (por exemplo, ??.id=10).
• params: os parâmetros que serão vinculados ao comando SQL gerado. Eles devem
ser informados em um vetor, com pares de nome-valor. Essa opção está disponível
desde a versão 1.0.3.
• on: representa a cláusula ON. A condição especificada aqui será adicionada à
condição de junção, utilizando-se o operador AND. Note que, para evitar conflitos
entre nomes de colunas iguais, os nomes delas devem ser diferenciados com a
utilização de um aliasToken, (por exemplo, ??.id=10). Essa opção não pode ser
utilizada em relações do tipo MANY_MANY. Ela está disponível desde a versão
1.0.2.
• order: representa a cláusula ORDER BY. Não tem nenhum valor por padrão. Note
que, para evitar conflitos entre nomes de colunas iguais, referencias a colunas
precisão ser identificadas por um aliasToken, (por exemplo, ??.age DESC).
• with: uma lista de objetos filhos relacionados que deverão ser carregados juntos com
esse objeto. Seja cuidadoso, pois utilizar esta opção de forma inapropriada poderá
gerar um loop infinito nos relacionamentos.
• joinType: o tipo de junção nesse relacionamento. Por padrão é LEFT OUTER JOIN.
• aliasToken: é o marcador do prefixo da coluna. Ele será substituído pelo apelido da
tabela correspondente para diferenciar as referencias às colunas. Seu padrão é '??.'.
• alias: o apelido para a tabela associada a esse relacionamento. Essa opção está
disponível desde a versão 1.0.1. Por padrão é null, indicando que o apelido para a
tabela será gerado automaticamente. Um alias é diferente de uma aliasToken, uma
vez que esse último é só um marcador que será substituído pelo verdadeiro apelido
para a tabela.
• together: especifica se a tabela associada com esse relacionamento deverá ser
forçada a juntar-se a tabela primária. Essa opção só faz sentido em relacionamentos
do tipo HAS_MANY e MANY_MANY. Se está opção não for utilizada, ou seu valor for
false, cada relacionamento HAS_MANY e MANY_MANY terão suas próprias