Fonctions de table (sauf UDTFs SQL) : restrictions concernant les fonctions de tables latérales et les jointures latérales externes¶

Dans la version actuelle, les éléments suivants ne sont plus autorisés :

• Les fonctions des tables latérales (autres que des UDTFs SQL) qui sont spécifiées avec la clause ON.

• Jointures latérales externes vers des fonctions de table (autres que des UDTFs SQL) qui spécifient la clause ON.

Notez que cette restriction s’applique également aux instructions qui utilisent des clauses équivalentes à la clause ON (la clause USING et NATURAL JOIN).

Les fonctions de table autres que des UDTFs SQL comprennent les fonctions de table intégrées et les UDTFs définies dans des langages autres que SQL.

Précédemment

Vous pouviez spécifier :

• La clause ON (ou la clause USING ou NATURAL JOIN) pour les fonctions de table latérales (autres que des UDTFs SQL).

  Par exemple :

  SELECT ... FROM my_table
  JOIN TABLE(FLATTEN(input=>[col_a]))
  ON ... ;
  SELECT ... FROM my_table
  INNER JOIN TABLE(FLATTEN(input=>[col_a]))
  ON ... ;
  SELECT ... FROM my_table
  JOIN TABLE(my_js_udtf(col_a))
  ON ...;
  SELECT ... FROM my_table
  INNER JOIN TABLE(my_js_udtf(col_a))
  ON ... ;
  

  Copy

• Une jointure latérale externe à une fonction de table (autre que des UDTFs SQL), en utilisant la clause ON (ou la clause USING ou NATURAL JOIN).

  Par exemple :

  SELECT ... FROM my_table
  LEFT JOIN TABLE(FLATTEN(input=>[col_a]))
  ON ... ;
  SELECT ... FROM my_table
  FULL JOIN TABLE(FLATTEN(input=>[col_a]))
  ON ... ;
  SELECT ... FROM my_table
  LEFT JOIN TABLE(my_js_udtf(col_a))
  ON ... ;
  SELECT ... FROM my_table
  FULL JOIN TABLE(my_js_udtf(col_a))
  ON ... ;
  

  Copy

Actuellement

Lorsque vous exécutez les instructions ci-dessus, une erreur se produit avec le message suivant :

000002 (0A000): Unsupported feature 'lateral table function called with
    OUTER JOIN syntax or a join predicate (ON clause)'

Copy

Cette restriction ne s’applique pas si vous utilisez une virgule pour spécifier la jointure :

SELECT ... FROM <table>,
    TABLE(<ptable_function_other_than_sql_udtf>) ... ;

Par exemple :

SELECT ... FROM my_table,
TABLE(FLATTEN(input=>[col_a]));

Cette restriction ne s’applique pas non plus si la clause ON (ou la clause USING ou NATURAL JOIN) n’est pas spécifiée :

SELECT ... FROM <table>
[{ [ INNER  | { LEFT | RIGHT | FULL } [ OUTER ] | CROSS } JOIN
TABLE(<table_function_other_than_sql_udtf>) ...;

Par exemple :

SELECT ... FROM my_table
FULL JOIN TABLE(FLATTEN(input=>[col_a]));
SELECT ... FROM my_table
LEFT JOIN OUTER TABLE(FLATTEN(input=>[col_a]));

Cette restriction était ajoutée parce que ce type de requêtes peut donner lieu à des comportements incohérents. Ces types de requêtes ne sont pas pris en charge.

Réf : 1057