Raise repairs on platform setup for sql (home-assistant#153581)

Author: gjohansson-ST

homeassistant/components/sql/sensor.py

@@ -30,6 +30,7 @@
     AddConfigEntryEntitiesCallback,
     AddEntitiesCallback,
 )
+from homeassistant.helpers.issue_registry import IssueSeverity, async_create_issue
 from homeassistant.helpers.template import Template
 from homeassistant.helpers.trigger_template_entity import (
     CONF_AVAILABILITY,
@@ -69,6 +70,15 @@ async def async_setup_platform(
 ) -> None:
     """Set up the SQL sensor from yaml."""
     if (conf := discovery_info) is None:
+        async_create_issue(
+            hass,
+            DOMAIN,
+            "sensor_platform_yaml_not_supported",
+            is_fixable=False,
+            severity=IssueSeverity.WARNING,
+            translation_key="platform_yaml_not_supported",
+            learn_more_url="https://www.home-assistant.io/integrations/sql/",
+        )
         return
 
     name: Template = conf[CONF_NAME]

homeassistant/components/sql/strings.json

@@ -166,6 +166,10 @@
     "entity_id_query_does_full_table_scan": {
       "title": "SQL query does full table scan",
       "description": "The query `{query}` contains the keyword `entity_id` but does not reference the `states_meta` table. This will cause a full table scan and database instability. Please check the documentation and use `states_meta.entity_id` instead."
+    },
+    "platform_yaml_not_supported": {
+      "title": "Platform YAML is not supported for SQL",
+      "description": "Platform YAML setup is not supported.\nChange from configuring it in the `sensor:` key to use the `sql:` key directly in configuration.yaml.\nClick on learn more to see the documentation for details."
     }
   }
 }

tests/components/sql/test_sensor.py

@@ -345,7 +345,7 @@ async def test_templates_with_yaml(
 
 
 async def test_config_from_old_yaml(
-    recorder_mock: Recorder, hass: HomeAssistant
+    recorder_mock: Recorder, hass: HomeAssistant, issue_registry: ir.IssueRegistry
 ) -> None:
     """Test the SQL sensor from old yaml config does not create any entity."""
     config = {
@@ -366,6 +366,9 @@ async def test_config_from_old_yaml(
 
     state = hass.states.get("sensor.count_tables")
     assert not state
+    issue = issue_registry.async_get_issue(DOMAIN, "sensor_platform_yaml_not_supported")
+    assert issue is not None
+    assert issue.severity == ir.IssueSeverity.WARNING
 
 
 @pytest.mark.parametrize(