Add descriptions for columns with blank descriptions (batch 1/89)

sql/moz-fx-data-shared-prod/accounts_backend_derived/monitoring_db_counts_v1/schema.yaml

@@ -2,9 +2,12 @@ fields:
 - name: as_of_date
   type: DATE
   mode: NULLABLE
+  description: 'Date of as of. Computed as: @as_of_date.'
 - name: table_name
   type: STRING
   mode: NULLABLE
+  description: 'Name of table. Computed as: "accounts_linked_to_apple".'
 - name: total_rows
   type: INTEGER
   mode: NULLABLE
+  description: 'Total value of rows. Computed as: COUNT(uid).'

sql/moz-fx-data-shared-prod/accounts_backend_derived/monitoring_db_recovery_phones_counts_v1/schema.yaml

@@ -2,9 +2,12 @@ fields:
 - name: as_of_date
   type: DATE
   mode: NULLABLE
+  description: 'Date of as of. Computed as: @as_of_date.'
 - name: country_code
   type: STRING
   mode: NULLABLE
+  description: 'Code for country. Computed as: SAFE.JSON_VALUE(lookupData, ''$.countryCode'').'
 - name: total_rows
   type: INTEGER
   mode: NULLABLE
+  description: 'Total value of rows. Computed as: COUNT(uid).'

sql/moz-fx-data-shared-prod/accounts_backend_derived/users_services_daily_v1/schema.yaml

@@ -2,22 +2,32 @@ fields:
 - name: submission_date
   type: DATE
   mode: NULLABLE
+  description: 'Date of submission. Computed as: DATE(@submission_date).'
 - name: user_id_sha256
   type: STRING
   mode: NULLABLE
+  description: 'String/text field for user id sha256. Computed as: metrics.string.account_user_id_sha256.'
 - name: service
   type: STRING
   mode: NULLABLE
+  description: 'String/text field for service. Computed as: ).'
 - name: country
   type: STRING
   mode: NULLABLE
+  description: 'String/text field for country. Computed as: `moz-fx-data-shared-prod.udf.mode_last`(ARRAY_AGG(country)
+    OVER w1).'
 - name: seen_in_tier1_country
   type: BOOLEAN
   mode: NULLABLE
+  description: 'Boolean flag for seen in tier1 country. Computed as: udf_contains_tier1_country(ARRAY_AGG(country)
+    OVER w1).'
 - name: registered
   type: BOOLEAN
   mode: NULLABLE
+  description: 'Boolean flag for registered. Computed as: LOGICAL_OR(event_name =
+    ''reg_complete'') OVER w1.'
 - name: user_agent_device_count
   type: INTEGER
   mode: NULLABLE
-  description: Number of devices associated with the user, per service, per day. Estimated from the number of unique user agent strings.
+  description: Number of devices associated with the user, per service, per day. Estimated
+    from the number of unique user agent strings.

sql/moz-fx-data-shared-prod/accounts_backend_derived/users_services_last_seen_v1/schema.yaml

@@ -2,31 +2,39 @@ fields:
 - mode: NULLABLE
   name: submission_date
   type: DATE
+  description: 'Date of submission. Computed as: @submission_date.'
 - mode: NULLABLE
   name: user_id_sha256
   type: STRING
+  description: String/text field for user id sha256.
 - mode: NULLABLE
   name: service
   type: STRING
+  description: String/text field for service.
 - mode: NULLABLE
   name: country
   type: STRING
+  description: String/text field for country.
 - mode: NULLABLE
   name: days_seen_bits
   type: INTEGER
-  description: |
-    No. of days since the user had activity event.
+  description: 'No. of days since the user had activity event.
+
+    '
 - mode: NULLABLE
   name: days_seen_in_tier1_country_bits
   type: INTEGER
-  description: |
-    No. of days since seen_in_tier1_country was last True.
+  description: 'No. of days since seen_in_tier1_country was last True.
+
+    '
 - mode: NULLABLE
   name: days_registered_bits
   type: INTEGER
-  description: |
-    No. of days since registration event.
+  description: 'No. of days since registration event.
+
+    '
 - name: user_agent_device_count
   type: INTEGER
   mode: NULLABLE
-  description: Number of devices associated with the user, per service, per day. Estimated from the number of unique user agent strings.
+  description: Number of devices associated with the user, per service, per day. Estimated
+    from the number of unique user agent strings.

sql/moz-fx-data-shared-prod/accounts_backend_external/accounts_v1/schema.yaml

@@ -1,47 +1,69 @@
 fields:
-  - name: uid
-    type: STRING
-    mode: NULLABLE
-    description: |-
-      Account ID in hexadecimal format.
-      FxA stores this as bytes, for purposes of logging or integration
-      with other systems we convert it to a hex string.
-  - name: normalizedEmail
-    type: STRING
-    mode: NULLABLE
-  - name: email
-    type: STRING
-    mode: NULLABLE
-  - name: emailVerified
-    type: BOOLEAN
-    mode: NULLABLE
-  - name: verifierVersion
-    type: INTEGER
-    mode: NULLABLE
-  - name: verifierSetAt
-    type: TIMESTAMP
-    mode: NULLABLE
-  - name: createdAt
-    type: TIMESTAMP
-    mode: NULLABLE
-  - name: locale
-    type: STRING
-    mode: NULLABLE
-  - name: lockedAt
-    type: TIMESTAMP
-    mode: NULLABLE
-  - name: profileChangedAt
-    type: TIMESTAMP
-    mode: NULLABLE
-  - name: keysChangedAt
-    type: TIMESTAMP
-    mode: NULLABLE
-  - name: ecosystemAnonId
-    type: STRING
-    mode: NULLABLE
-  - name: disabledAt
-    type: TIMESTAMP
-    mode: NULLABLE
-  - name: metricsOptOutAt
-    type: TIMESTAMP
-    mode: NULLABLE
+- name: uid
+  type: STRING
+  mode: NULLABLE
+  description: 'Account ID in hexadecimal format.
+
+    FxA stores this as bytes, for purposes of logging or integration
+
+    with other systems we convert it to a hex string.'
+- name: normalizedEmail
+  type: STRING
+  mode: NULLABLE
+  description: String/text field for normalized email.
+- name: email
+  type: STRING
+  mode: NULLABLE
+  description: String/text field for email.
+- name: emailVerified
+  type: BOOLEAN
+  mode: NULLABLE
+  description: 'Boolean flag for email verified. Computed as: SAFE_CAST(emailVerified
+    AS BOOL).'
+- name: verifierVersion
+  type: INTEGER
+  mode: NULLABLE
+  description: Numeric value representing verifier version.
+- name: verifierSetAt
+  type: TIMESTAMP
+  mode: NULLABLE
+  description: 'Timestamp/date field for verifier set at. Computed as: SAFE.TIMESTAMP_MILLIS(SAFE_CAST(verifierSetAt
+    AS INT)).'
+- name: createdAt
+  type: TIMESTAMP
+  mode: NULLABLE
+  description: 'Timestamp/date field for created at. Computed as: SAFE.TIMESTAMP_MILLIS(SAFE_CAST(createdAt
+    AS INT)).'
+- name: locale
+  type: STRING
+  mode: NULLABLE
+  description: String/text field for locale.
+- name: lockedAt
+  type: TIMESTAMP
+  mode: NULLABLE
+  description: 'Timestamp/date field for locked at. Computed as: SAFE.TIMESTAMP_MILLIS(SAFE_CAST(lockedAt
+    AS INT)).'
+- name: profileChangedAt
+  type: TIMESTAMP
+  mode: NULLABLE
+  description: 'Timestamp/date field for profile changed at. Computed as: SAFE.TIMESTAMP_MILLIS(SAFE_CAST(profileChangedAt
+    AS INT)).'
+- name: keysChangedAt
+  type: TIMESTAMP
+  mode: NULLABLE
+  description: 'Timestamp/date field for keys changed at. Computed as: SAFE.TIMESTAMP_MILLIS(SAFE_CAST(keysChangedAt
+    AS INT)).'
+- name: ecosystemAnonId
+  type: STRING
+  mode: NULLABLE
+  description: String/text field for ecosystem anon id.
+- name: disabledAt
+  type: TIMESTAMP
+  mode: NULLABLE
+  description: 'Timestamp/date field for disabled at. Computed as: SAFE.TIMESTAMP_MILLIS(SAFE_CAST(disabledAt
+    AS INT)).'
+- name: metricsOptOutAt
+  type: TIMESTAMP
+  mode: NULLABLE
+  description: 'Timestamp/date field for metrics opt out at. Computed as: SAFE.TIMESTAMP_MILLIS(SAFE_CAST(metricsOptOutAt
+    AS INT)).'