[SPARK-54541][SQL] Rename _LEGACY_ERROR_TEMP_1007 and add sqlState

### What changes were proposed in this pull request?

I renamed _LEGACY_ERROR_TEMP_1007 to VIEW_WRITE_NOT_ALLOWED and added sqlState 42809.

The changes include:
- New error class VIEW_WRITE_NOT_ALLOWED in error-conditions.json with sqlState 42809
- Updated QueryCompilationErrors.scala to reference the new error class
- Refactored 6 test cases in DataFrameWriterV2Suite to use checkError() instead of string matching

### Why are the changes needed?

Users frequently encounter this error when attempting to write to temporary views using the DataFrameWriter V2 API. The legacy error name is non-descriptive and lacks an sqlState, which makes it difficult to handle programatically and reduces compatibility with JDBC/ODBC clients.

### Does this PR introduce any user-facing change?

No. The error message text stays the same. User will only see the same error message, but the underlying error class is now properly named and includes a sqlState for better tooling support.

### How was this patch tested?

I tested this change in multiple ways:
- Manually triggered the error in spark-shell to verify the new error class is used
- Updated 6 existing tests in DataFrameWriterV2Suite to use checkError() for structured validation of error class and parameters
- Ran the full test suite: all tests pass successfully

#### Manual Testing in Spark-Shell

**Before (legacy error):**

```
scala> val sourceData = Seq((1, "a"), (2, "b"), (3, "c")).toDF("id", "name")
scala> sourceData.createOrReplaceTempView("source")
scala> spark.range(10).createOrReplaceTempView("temp_view")
scala> spark.table("source").writeTo("temp_view").append()

org.apache.spark.sql.AnalysisException: Cannot write into temp view temp_view as it's not a data source v2 relation.
at org.apache.spark.sql.errors.QueryCompilationErrors$.writeIntoTempViewNotAllowedError(QueryCompilationErrors.scala:551)
at org.apache.spark.sql.catalyst.analysis.Analyzer$ResolveRelations$$anonfun$apply$12.$anonfun$applyOrElse$73(Analyzer.scala:1237)

```

**After (new error with class and sqlState):**
```
scala> val sourceData = Seq((1, "a"), (2, "b"), (3, "c")).toDF("id", "name")
scala> sourceData.createOrReplaceTempView("source")
scala> spark.range(10).createOrReplaceTempView("temp_view")
scala> spark.table("source").writeTo("temp_view").append()

org.apache.spark.sql.AnalysisException: [VIEW_WRITE_NOT_ALLOWED] Cannot write into view temp_view, please write into a table instead. SQLSTATE: 42809
  at org.apache.spark.sql.errors.QueryCompilationErrors$.writeIntoTempViewNotAllowedError(QueryCompilationErrors.scala:551)
  at org.apache.spark.sql.catalyst.analysis.Analyzer$ResolveRelations$$anonfun$apply$12.$anonfun$applyOrElse$73(Analyzer.scala:1237)
```

*Note: The error now displays the error class `[VIEW_WRITE_NOT_ALLOWED]` and includes sqlState `42809` (accessible via `getSqlState()`).*

Ran the full DataFrameWriterV2Suite test suite: all tests pass successfully

```
[info] Test run finished: 0 failed, 0 ignored, 6 total, 0.602s
[info] ScalaTest
[info] Run completed in 8 seconds, 683 milliseconds.
[info] Total number of tests run: 48
[info] Suites: completed 1, aborted 0
[info] Tests: succeeded 48, failed 0, canceled 0, ignored 0, pending 0
[info] All tests passed.
[info] Passed: Total 54, Failed 0, Errors 0, Passed 54
[success] Total time: 38 s, completed 13-Dec-2025, 10:51:11 pm
```

### Was this patch authored or co-authored using generative AI tooling?
No

Closes apache#53251 from AbinayaJayaprakasam/SPARK-fix-54541-PR.

Authored-by: AbinayaJayaprakasam <jaiabiman@gmail.com>
Signed-off-by: Wenchen Fan <wenchen@databricks.com>

Author: AbinayaJayaprakasam

common/utils/src/main/resources/error/error-conditions.json

@@ -7482,6 +7482,12 @@
     ],
     "sqlState" : "42P01"
   },
+  "VIEW_WRITE_NOT_ALLOWED" : {
+    "message" : [
+      "Cannot write into view <name>, please write into a table instead."
+    ],
+    "sqlState" : "42809"
+  },
   "WINDOW_FUNCTION_AND_FRAME_MISMATCH" : {
     "message" : [
       "<funcName> function can only be evaluated in an ordered row-based window frame with a single offset: <windowExpr>."
@@ -7706,21 +7712,11 @@
       "Aggregate expression required for pivot, but '<sql>' did not appear in any aggregate function."
     ]
   },
-  "_LEGACY_ERROR_TEMP_1007" : {
-    "message" : [
-      "Cannot write into temp view <quoted> as it's not a data source v2 relation."
-    ]
-  },
   "_LEGACY_ERROR_TEMP_1008" : {
     "message" : [
       "<quoted> is not a temp view of streaming logical plan, please use batch API such as `DataFrameReader.table` to read it."
     ]
   },
-  "_LEGACY_ERROR_TEMP_1011" : {
-    "message" : [
-      "Writing into a view is not allowed. View: <identifier>."
-    ]
-  },
   "_LEGACY_ERROR_TEMP_1012" : {
     "message" : [
       "Cannot write into v1 table: <identifier>."

sql/catalyst/src/main/scala/org/apache/spark/sql/errors/QueryCompilationErrors.scala

@@ -547,8 +547,8 @@ private[sql] object QueryCompilationErrors extends QueryErrorsBase with Compilat
 
   def writeIntoTempViewNotAllowedError(quoted: String): Throwable = {
     new AnalysisException(
-      errorClass = "_LEGACY_ERROR_TEMP_1007",
-      messageParameters = Map("quoted" -> quoted))
+      errorClass = "VIEW_WRITE_NOT_ALLOWED",
+      messageParameters = Map("name" -> quoted))
   }
 
   def readNonStreamingTempViewError(quoted: String): Throwable = {
@@ -578,8 +578,8 @@ private[sql] object QueryCompilationErrors extends QueryErrorsBase with Compilat
 
   def writeIntoViewNotAllowedError(identifier: TableIdentifier, t: TreeNode[_]): Throwable = {
     new AnalysisException(
-      errorClass = "_LEGACY_ERROR_TEMP_1011",
-      messageParameters = Map("identifier" -> identifier.toString),
+      errorClass = "VIEW_WRITE_NOT_ALLOWED",
+      messageParameters = Map("name" -> toSQLId(identifier.nameParts)),
       origin = t.origin)
   }
 

sql/core/src/test/scala/org/apache/spark/sql/DataFrameWriterV2Suite.scala

@@ -165,19 +165,24 @@ class DataFrameWriterV2Suite extends QueryTest with SharedSparkSession with Befo
 
   test("Append: fail if it writes to a temp view that is not v2 relation") {
     spark.range(10).createOrReplaceTempView("temp_view")
-    val exc = intercept[AnalysisException] {
-      spark.table("source").writeTo("temp_view").append()
-    }
-    assert(exc.getMessage.contains("Cannot write into temp view temp_view as it's not a " +
-      "data source v2 relation"))
+    checkError(
+      exception = intercept[AnalysisException] {
+        spark.table("source").writeTo("temp_view").append()
+      },
+      condition = "VIEW_WRITE_NOT_ALLOWED",
+      parameters = Map("name" -> "temp_view")
+    )
   }
 
   test("Append: fail if it writes to a view") {
     spark.sql("CREATE VIEW v AS SELECT 1")
-    val exc = intercept[AnalysisException] {
-      spark.table("source").writeTo("v").append()
-    }
-    assert(exc.getMessage.contains("Writing into a view is not allowed"))
+    checkError(
+      exception = intercept[AnalysisException] {
+        spark.table("source").writeTo("v").append()
+      },
+      condition = "VIEW_WRITE_NOT_ALLOWED",
+      parameters = Map("name" -> "`spark_catalog`.`default`.`v`")
+    )
   }
 
   test("Append: fail if it writes to a v1 table") {
@@ -270,19 +275,24 @@ class DataFrameWriterV2Suite extends QueryTest with SharedSparkSession with Befo
 
   test("Overwrite: fail if it writes to a temp view that is not v2 relation") {
     spark.range(10).createOrReplaceTempView("temp_view")
-    val exc = intercept[AnalysisException] {
-      spark.table("source").writeTo("temp_view").overwrite(lit(true))
-    }
-    assert(exc.getMessage.contains("Cannot write into temp view temp_view as it's not a " +
-      "data source v2 relation"))
+    checkError(
+      exception = intercept[AnalysisException] {
+        spark.table("source").writeTo("temp_view").overwrite(lit(true))
+      },
+      condition = "VIEW_WRITE_NOT_ALLOWED",
+      parameters = Map("name" -> "temp_view")
+    )
   }
 
   test("Overwrite: fail if it writes to a view") {
     spark.sql("CREATE VIEW v AS SELECT 1")
-    val exc = intercept[AnalysisException] {
-      spark.table("source").writeTo("v").overwrite(lit(true))
-    }
-    assert(exc.getMessage.contains("Writing into a view is not allowed"))
+    checkError(
+      exception = intercept[AnalysisException] {
+        spark.table("source").writeTo("v").overwrite(lit(true))
+      },
+      condition = "VIEW_WRITE_NOT_ALLOWED",
+      parameters = Map("name" -> "`spark_catalog`.`default`.`v`")
+    )
   }
 
   test("Overwrite: fail if it writes to a v1 table") {
@@ -375,19 +385,24 @@ class DataFrameWriterV2Suite extends QueryTest with SharedSparkSession with Befo
 
   test("OverwritePartitions: fail if it writes to a temp view that is not v2 relation") {
     spark.range(10).createOrReplaceTempView("temp_view")
-    val exc = intercept[AnalysisException] {
-      spark.table("source").writeTo("temp_view").overwritePartitions()
-    }
-    assert(exc.getMessage.contains("Cannot write into temp view temp_view as it's not a " +
-      "data source v2 relation"))
+    checkError(
+      exception = intercept[AnalysisException] {
+        spark.table("source").writeTo("temp_view").overwritePartitions()
+      },
+      condition = "VIEW_WRITE_NOT_ALLOWED",
+      parameters = Map("name" -> "temp_view")
+    )
   }
 
   test("OverwritePartitions: fail if it writes to a view") {
     spark.sql("CREATE VIEW v AS SELECT 1")
-    val exc = intercept[AnalysisException] {
-      spark.table("source").writeTo("v").overwritePartitions()
-    }
-    assert(exc.getMessage.contains("Writing into a view is not allowed"))
+    checkError(
+      exception = intercept[AnalysisException] {
+        spark.table("source").writeTo("v").overwritePartitions()
+      },
+      condition = "VIEW_WRITE_NOT_ALLOWED",
+      parameters = Map("name" -> "`spark_catalog`.`default`.`v`")
+    )
   }
 
   test("OverwritePartitions: fail if it writes to a v1 table") {