calendar_definition

Aperçu : cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section Conditions générales du service des Conditions spécifiques au service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Si vous rencontrez un problème lors de la version Preview publique des calendriers personnalisés, signalez-le à l'adresse [e-mail].

Utilisation

view: retail_custom_calendar {
  calendar_definition: {
    reference_date: ref_date
    timeframe_mapping: {
      custom_date: custom_date
      custom_period: custom_period
      custom_quarter: custom_quarter
      custom_season: custom_season
      custom_week: custom_week
      custom_year: custom_year
    }
    timeframe_ordinal_mapping: {
      custom_date: custom_date
      custom_period: custom_period
      custom_quarter: custom_quarter
      custom_season: custom_season
      custom_week: custom_week
      custom_year: custom_year
    }
    previous_ordinal_mapping: {
      custom_date: custom_date
      custom_week: custom_week
    }
  }

Hiérarchie Afficher le fichier view calendar_definition

Définition

Lorsque vous utilisez des calendriers personnalisés dans Looker, le paramètre calendar_definition vous permet de mapper les périodes du calendrier personnalisé Looker aux colonnes d'une table de calendrier personnalisé que vous avez créée dans votre base de données.

Pour savoir comment configurer un fichier d'affichage de calendrier personnalisé, consultez la page de documentation Utiliser des calendriers personnalisés dans Looker.

Dans le fichier d'affichage de votre calendrier personnalisé, ajoutez le bloc de paramètres calendar_definition. Exemple :

  calendar_definition: {
    reference_date: ref_date
    timeframe_mapping: {
      custom_date: custom_date
      custom_period: custom_period
      custom_quarter: custom_quarter
      custom_season: custom_season
      custom_week: custom_week
      custom_year: custom_year
    }
    timeframe_ordinal_mapping: {
      custom_date: ordinal_custom_date
      custom_period: ordinal_custom_period
      custom_quarter: ordinal_custom_quarter
      custom_season: ordinal_custom_season
      custom_week: ordinal_custom_week
      custom_year: ordinal_custom_year
    }
    previous_ordinal_mapping: {
      custom_date: prev_day_num
      custom_week: prev_week_num
    }
  }

Notez les points suivants concernant le bloc de paramètres calendar_definition :

• Le paramètre reference_date est obligatoire.
• Les paramètres timeframe_mapping et timeframe_ordinal_mapping, ainsi que tous leurs sous-paramètres, sont obligatoires. Pour en savoir plus, consultez Délais obligatoires.
• Le bloc de paramètres previous_ordinal_mapping n'est requis que si vous souhaitez utiliser le calendrier personnalisé avec des mesures période par période.

Consultez la section Exemple sur cette page.

Après avoir modélisé la table de calendrier personnalisée dans LookML, vous pouvez créer un groupe de dimensions type: custom_calendar basé sur la vue de calendrier personnalisée. Vos utilisateurs finaux peuvent ensuite créer des requêtes Explorer à l'aide des périodes de la dimension de calendrier personnalisée.

reference_date

Le paramètre reference_date spécifie une dimension dans votre vue de calendrier personnalisée qui correspond à la colonne de votre table de base de données de calendrier personnalisée qui fournit une date de calendrier standard, telle que 2026-01-01.

Notez les points suivants concernant le paramètre reference_date :

• Le reference_date est obligatoire, car Looker l'utilise pour calculer les jointures entre vos tables de données et votre table de calendrier personnalisée afin de fournir des résultats de requête qui utilisent vos périodes personnalisées.
• Le reference_date doit être unique ou une clé primaire.

Consultez la section Exemple sur cette page pour voir comment reference_date pointe vers une dimension qui modélise une colonne dans votre tableau de calendrier personnalisé.

timeframe_mapping

Le bloc timeframe_mapping mappe chaque période personnalisée Looker à la dimension qui modélise la colonne équivalente de la table de base de données de votre calendrier personnalisé.

timeframe_mapping: {
  custom_date: field-ref
  custom_period: field-ref
  custom_quarter: field-ref
  custom_season: field-ref
  custom_week: field-ref
  custom_year: field-ref
}

Remarque : Le paramètre timeframe_mapping et tous ses sous-paramètres sont obligatoires. Pour en savoir plus, consultez Délais obligatoires.

Consultez la section Exemple de cette page pour découvrir comment chaque sous-paramètre timeframe_mapping spécifie une dimension qui modélise une colonne dans votre tableau de calendrier personnalisé.

timeframe_ordinal_mapping

Le bloc timeframe_ordinal_mapping mappe chaque période personnalisée Looker à la dimension qui modélise la colonne ordinale appropriée de la table de base de données de votre calendrier personnalisé.

timeframe_ordinal_mapping: {
  custom_date: field-ref
  custom_period: field-ref
  custom_quarter: field-ref
  custom_season: field-ref
  custom_week: field-ref
  custom_year: field-ref
}

Remarque : Le paramètre timeframe_ordinal_mapping et tous ses sous-paramètres sont obligatoires. Pour en savoir plus, consultez Délais obligatoires.

Consultez la section Exemple de cette page pour découvrir comment chaque sous-paramètre timeframe_ordinal_mapping spécifie une dimension qui modélise une colonne dans votre tableau de calendrier personnalisé.

previous_ordinal_mapping

Si vous souhaitez créer des mesures de période sur période qui utilisent votre calendrier personnalisé, vous devez également ajouter un bloc previous_ordinal_mapping à votre calendar_definition.

Le bloc previous_ordinal_mapping mappe chaque période personnalisée Looker à la dimension qui modélise la colonne appropriée de la table de base de données de votre calendrier personnalisé.

previous_ordinal_mapping: {
  custom_date: field-ref
  custom_week: field-ref
}

Consultez la section Exemple de cette page pour découvrir comment chaque sous-paramètre previous_ordinal_mapping spécifie une dimension qui modélise une colonne dans votre tableau de calendrier personnalisé.

Délais obligatoires

Les sous-paramètres de période de timeframe_mapping et timeframe_ordinal_mapping sont obligatoires. Si une période spécifique, telle que custom_season, n'est pas pertinente pour votre calendrier personnalisé, vous devez quand même l'inclure en définissant une dimension d'espace réservé dans la vue de votre calendrier. Exemple :

 dimension: season {
    type: string
    sql: 'N/A' ;;
    hidden: yes
  }
  dimension: season_num {
    type: number
    sql: 0 ;;
    hidden: yes
  }

Exemple

Voici un exemple de fichier d'affichage appelé fiscal_calendar.view.lkml qui modélise une table de calendrier personnalisée appelée fiscal_calendar_table :

view: fiscal_calendar {
  sql_table_name: fiscal_calendar_table ;;

  calendar_definition: {
    reference_date: reference_date

    timeframe_mapping: {
      custom_year: fiscal_year
      custom_quarter: fiscal_quarter_of_year
      custom_date: fiscal_date_of_month
      custom_week: fiscal_week_of_year
      custom_period: fiscal_period_of_year
      custom_season: season
    }
    timeframe_ordinal_mapping: {
      custom_year: fiscal_year_num
      custom_quarter: fiscal_quarter_of_year_num
      custom_date: fiscal_date_of_month_num
      custom_week: fiscal_week_of_year_num
      custom_period: fiscal_period_of_year_num
      custom_season: season_num
    }
    previous_ordinal_mapping: {
          custom_date: prev_custom_date
          custom_week: prev_custom_week
    }
  }

  dimension: reference_date {
    type: date
    primary_key: yes
    sql: ${TABLE}.reference_date ;; # Name of the column in your database table that shows the standard date, such as `2026-01-01`
  }

  dimension: fiscal_year {
    type: string
    sql: ${TABLE}.fiscal_year ;;
  }

  dimension: fiscal_year_num {
    type: number
    sql: ${TABLE}.fiscal_year_num ;;
  }

  dimension: prev_custom_week {
          type: number
          sql: ${TABLE}.prev_custom_week ;;
        }

  # ... other dimensions for quarters, weeks, periods, seasons, etc. ...

  # Example placeholder dimensions for unused timeframes
  dimension: season {
    type: string
    sql: 'N/A' ;;
    hidden: yes
  }
  dimension: season_num {
    type: number
    sql: 0 ;;
    hidden: yes
  }
}