Função ML.HOLIDAY_INFO

Neste documento, descrevemos a função ML.HOLIDAY_INFO, que pode ser usada para retornar a lista de feriados definida por um modelo de previsão de série temporal ARIMA_PLUS ou ARIMA_PLUS_XREG. A função retornará a lista de feriados somente se detectar um efeito de feriados no modelo. Caso contrário, ela retornará um conjunto vazio de resultados.

Sintaxe

ML.HOLIDAY_INFO(MODEL `project_id.dataset.model`)

Argumentos

ML.HOLIDAY_INFO usa os seguintes argumentos:

  • project_id: o ID do projeto.
  • dataset: o conjunto de dados do BigQuery que contém o modelo.
  • model: o nome do modelo

Saída

ML.HOLIDAY_INFO retorna as seguintes colunas:

  • region: um valor de STRING que identifica a região de feriado.
  • holiday_name: um valor de STRING que identifica o feriado.
  • primary_date: um valor de DATE que identifica a data em que o feriado cai.
  • preholiday_days: um valor INT64 que identifica o início da janela de feriado próxima ao feriado que foi considerado na modelagem.
  • postholiday_days: um valor INT64 que identifica o fim da janela de férias próxima ao feriado, que foi considerado na modelagem.

Exemplo

O exemplo a seguir retorna os resultados de um modelo que usa um feriado personalizado:

SELECT * FROM
ML.HOLIDAY_INFO(MODEL `mydataset.arima_model`);

A saída será assim:

+-----------------------+--------------+-----------------+------------------+
| region | holiday_name | primary_date | preholiday_days | postholiday_days |
+--------------------------------------------------------+------------------+
| US     | Members day  | 2001-10-21   | 3               | 1                |
+-----------------------+--------------+-----------------+------------------+
| US     | Members day  | 2002-10-22   | 3               | 1                |
+-----------------------+--------------+-----------------+------------------+
| US     | Members day  | 2003-10-21   | 3               | 1                |
+-----------------------+--------------+-----------------+------------------+
| US     | Members day  | 2004-10-23   | 3               | 1                |
+-----------------------+--------------+-----------------+------------------+

A seguir