chore(metadata-completeness): Add column descriptions

bigquery_etl/schema/global.yaml

@@ -89,6 +89,14 @@ fields:
 - name: dau
   type: INTEGER
   description: The number of daily active users.
+- name: first_run_date
+  type: DATE
+  mode: NULLABLE
+  description: The date of the first run of the application.
+- name: first_seen_date
+  type: DATE
+  mode: NULLABLE
+  description: Date when the server first received a ping from this client.
 - name: wau
   type: INTEGER
   description: The number of weekly active users.

sql/moz-fx-data-shared-prod/amo_prod/amo_stats_dau_v2/schema.yaml

@@ -0,0 +1,72 @@
+fields:
+- mode: NULLABLE
+  name: submission_date
+  type: DATE
+  description: The date when the telemetry ping is received on the server side.
+- name: addon_id
+  type: STRING
+  mode: NULLABLE
+- name: dau
+  type: INTEGER
+  mode: NULLABLE
+  description: The number of daily active users.
+- name: dau_by_addon_version
+  type: RECORD
+  mode: REPEATED
+  fields:
+  - name: key
+    type: STRING
+    mode: NULLABLE
+  - name: value
+    type: INTEGER
+    mode: NULLABLE
+- name: dau_by_app_version
+  type: RECORD
+  mode: REPEATED
+  fields:
+  - name: key
+    type: STRING
+    mode: NULLABLE
+  - name: value
+    type: INTEGER
+    mode: NULLABLE
+- name: dau_by_fenix_build
+  type: RECORD
+  mode: REPEATED
+  fields:
+  - name: key
+    type: STRING
+    mode: NULLABLE
+  - name: value
+    type: INTEGER
+    mode: NULLABLE
+- name: dau_by_locale
+  type: RECORD
+  mode: REPEATED
+  fields:
+  - name: key
+    type: STRING
+    mode: NULLABLE
+  - name: value
+    type: INTEGER
+    mode: NULLABLE
+- name: dau_by_country
+  type: RECORD
+  mode: REPEATED
+  fields:
+  - name: key
+    type: STRING
+    mode: NULLABLE
+  - name: value
+    type: INTEGER
+    mode: NULLABLE
+- name: dau_by_app_os
+  type: RECORD
+  mode: REPEATED
+  fields:
+  - name: key
+    type: STRING
+    mode: NULLABLE
+  - name: value
+    type: INTEGER
+    mode: NULLABLE

sql/moz-fx-data-shared-prod/amo_prod/desktop_addons_by_client_v1/schema.yaml

@@ -0,0 +1,40 @@
+fields:
+- mode: NULLABLE
+  name: submission_date
+  type: DATE
+  description: The date when the telemetry ping is received on the server side.
+- name: client_id
+  type: STRING
+  mode: NULLABLE
+  description: A unique identifier (UUID) for the client.
+- name: sample_id
+  type: INTEGER
+  mode: NULLABLE
+  description: A number, 0-99, that samples by client_id and allows filtering data
+    for analysis. It is a pipeline-generated artifact that should match between pings.
+- name: app_version
+  type: STRING
+  mode: NULLABLE
+  description: User visible version string (e.g. "1.0.3") for the browser.
+- name: country
+  type: STRING
+  mode: NULLABLE
+  description: Name of the country in which the activity took place, as determined
+    by the IP geolocation.
+- name: locale
+  type: STRING
+  mode: NULLABLE
+  description: Set of language- and/or country-based preferences for a user interface.
+- name: app_os
+  type: STRING
+  mode: NULLABLE
+- name: addons
+  type: RECORD
+  mode: REPEATED
+  fields:
+  - name: id
+    type: STRING
+    mode: NULLABLE
+  - name: version
+    type: STRING
+    mode: NULLABLE

sql/moz-fx-data-shared-prod/amo_prod/fenix_addons_by_client_v1/schema.yaml

@@ -0,0 +1,40 @@
+fields:
+- mode: NULLABLE
+  name: submission_date
+  type: DATE
+  description: The date when the telemetry ping is received on the server side.
+- name: client_id
+  type: STRING
+  mode: NULLABLE
+  description: A unique identifier (UUID) for the client.
+- name: sample_id
+  type: INTEGER
+  mode: NULLABLE
+  description: A number, 0-99, that samples by client_id and allows filtering data
+    for analysis. It is a pipeline-generated artifact that should match between pings.
+- name: app_version
+  type: STRING
+  mode: NULLABLE
+  description: User visible version string (e.g. "1.0.3") for the browser.
+- name: country
+  type: STRING
+  mode: NULLABLE
+  description: Name of the country in which the activity took place, as determined
+    by the IP geolocation.
+- name: locale
+  type: STRING
+  mode: NULLABLE
+  description: Set of language- and/or country-based preferences for a user interface.
+- name: app_os
+  type: STRING
+  mode: NULLABLE
+- name: addons
+  type: RECORD
+  mode: REPEATED
+  fields:
+  - name: addon
+    type: STRING
+    mode: NULLABLE
+  - name: version
+    type: STRING
+    mode: NULLABLE

sql/moz-fx-data-shared-prod/contextual_services_derived/adm_forecasting_v1/schema.yaml

@@ -5,12 +5,16 @@ fields:
 - mode: NULLABLE
   name: submission_date
   type: DATE
+  description: The date when the telemetry ping is received on the server side.
 - mode: NULLABLE
   name: country
   type: STRING
+  description: Name of the country in which the activity took place, as determined by
+    the IP geolocation.
 - mode: NULLABLE
   name: device
   type: STRING
+  description: Device Type - e.g. desktop or mobile.
 - mode: NULLABLE
   name: eligible_share_country
   type: FLOAT

sql/moz-fx-data-shared-prod/fenix_derived/attributable_clients_v1/schema.yaml

@@ -0,0 +1,53 @@
+fields:
+- name: submission_date
+  type: DATE
+  mode: NULLABLE
+  description: The date when the telemetry ping is received on the server side.
+- name: cohort_date
+  type: DATE
+  mode: NULLABLE
+- name: sample_id
+  type: INTEGER
+  mode: NULLABLE
+  description: A number, 0-99, that samples by client_id and allows filtering data
+    for analysis. It is a pipeline-generated artifact that should match between pings.
+- name: client_id
+  type: STRING
+  mode: NULLABLE
+  description: A unique identifier (UUID) for the client.
+- name: country
+  type: STRING
+  mode: NULLABLE
+  description: Name of the country in which the activity took place, as determined
+    by the IP geolocation.
+- name: adjust_network
+  type: STRING
+  mode: NULLABLE
+  description: The name of the Adjust Network that sourced the installation.
+- name: adjust_adgroup
+  type: STRING
+  mode: NULLABLE
+- name: adjust_campaign
+  type: STRING
+  mode: NULLABLE
+- name: adjust_creative
+  type: STRING
+  mode: NULLABLE
+- name: is_new_install
+  type: BOOLEAN
+  mode: NULLABLE
+- name: is_new_profile
+  type: BOOLEAN
+  mode: NULLABLE
+- name: searches
+  type: INTEGER
+  mode: NULLABLE
+- name: searches_with_ads
+  type: INTEGER
+  mode: NULLABLE
+- name: ad_clicks
+  type: INTEGER
+  mode: NULLABLE
+- name: activated
+  type: BOOLEAN
+  mode: NULLABLE

sql/moz-fx-data-shared-prod/fenix_derived/clients_yearly_v1/schema.yaml

@@ -18,6 +18,7 @@ fields:
 - name: first_run_date
   type: DATE
   mode: NULLABLE
+  description: The date of the first run of the application.
 - name: durations
   type: INTEGER
   mode: NULLABLE
@@ -41,16 +42,17 @@ fields:
 - name: android_sdk_version
   type: STRING
   mode: NULLABLE
-  description: The optional Android specific SDK version of the software running on this hardware device.
+  description: The optional Android specific SDK version of the software running on
+    this hardware device.
 - name: locale
   type: STRING
   mode: NULLABLE
   description: Set of language- and/or country-based preferences for a user interface.
 - name: city
   type: STRING
   mode: NULLABLE
-  description: Name of the city in which the activity took place, as determined
-    by the IP geolocation.
+  description: Name of the city in which the activity took place, as determined by
+    the IP geolocation.
 - name: country
   type: STRING
   mode: NULLABLE
@@ -69,25 +71,33 @@ fields:
 - name: architecture
   type: STRING
   mode: NULLABLE
+  description: The architecture of the device, (e.g. "arm", "x86").
 - name: device_manufacturer
   type: STRING
   mode: NULLABLE
+  description: The manufacturer of the device the application is running on.
 - name: device_model
   type: STRING
   mode: NULLABLE
+  description: The model of the device the application is running on.
+    On Android, this is Build.MODEL, the user-visible marketing name, like "Pixel 2 XL".
 - name: telemetry_sdk_build
   type: STRING
   mode: NULLABLE
-  description: The version of the Glean SDK at the time the ping was collected (e.g. 25.0.0).
+  description: The version of the Glean SDK at the time the ping was collected (e.g.
+    25.0.0).
 - name: first_seen_date
   type: DATE
   mode: NULLABLE
+  description: Date when the server first received a ping from this client.
 - name: is_new_profile
   type: BOOLEAN
   mode: NULLABLE
 - name: isp
   type: STRING
   mode: NULLABLE
+  description: The name of the internet service provider associated with the client's
+    IP address.
 - name: distribution_id
   type: STRING
   mode: NULLABLE

sql/moz-fx-data-shared-prod/firefox_desktop_derived/baseline_active_users_aggregates_v2/metadata.yaml

@@ -25,4 +25,4 @@ bigquery:
     - channel
     - country
 references: {}
-require_column_descriptions: false
+require_column_descriptions: true

sql/moz-fx-data-shared-prod/firefox_desktop_derived/review_checker_clients_v1/schema.yaml

@@ -15,6 +15,7 @@ fields:
 - name: legacy_client_id
   type: STRING
   mode: NULLABLE
+  description: A unique identifier (UUID) for the client, based on legacy telemetry data.
 - name: client_id
   type: STRING
   mode: NULLABLE

sql/moz-fx-data-shared-prod/mozilla_org_derived/blogs_goals_v1/schema.yaml

@@ -2,15 +2,20 @@ fields:
 - name: date
   type: DATE
   mode: NULLABLE
+  description: Date of the session
 - name: visit_identifier
   type: STRING
   mode: NULLABLE
+  description: The unique identifier for a visit, a concatenation of visitor ID and visit ID.
 - name: downloads
   type: INTEGER
   mode: NULLABLE
+  description: The number of downloads for this session.
 - name: social_share
   type: INTEGER
   mode: NULLABLE
+  description: The number of social shares for this session.
 - name: newsletter_subscription
   type: INTEGER
   mode: NULLABLE
+  description: The number of newsletter subscriptions for this session.