Recentemente houvede várias questões postou no Facebook.SO usandoCONTAINS() noWHERE cláusula. Parece funcionar como a função de pesquisa da API do Graph, e funciona como um campo indexado. Todas as grandes coisas para o desenvolvedor FQL.

SELECT name,
       username,
       type
FROM   profile
WHERE  CONTAINS("Facebook")

No entanto, a única menção oficial doCONTAINS função aparece nounified_thread documentação. É mencionado de passagem, como uma forma de procurar texto contido em uma mensagem. Ele também apareceu nesteamostra de código fbrell.

MasContains não parece ser uma pesquisa direta. Por exemplo, esta consulta:

SELECT name
FROM   user
WHERE  CONTAINS("Joe Biden")

retorna "Joe Biden" e também "Joseph Biden" e "Biden Joe". Mas também retorna "Joe Scardino", "Lindsay Noyan" e "Mehmad Moha" entre outros. Que relação essas pessoas têm com o vice-presidente dos EUA? Eles não são meus amigos, então eu nunca saberei.

Também parece haver a capacidade de passarCONTAINS um campo para pesquisar, no entanto, alterar o final da minha primeira consulta para `CONTAINS (" Facebook ", name) retorna um erro OAuth:

 (#615) 'name' is not a valid search field for the profile table.

Em meus testes não tão rigorosos, ainda não encontrei uma combinação de campo / tabela que não retorne esse erro.

Então, qual é essa função misteriosa? Como funciona? Pode nos permitir fazer coisas até hoje impossíveis no FQL como atravessar arrays e filtrar dados armazenados em strings?

Uma resposta aqui seria ótima, mas uma descrição em uma página de referência de funções e métodos FQL no site oficial de documentação do desenvolvedor seria melhor ainda.