This is an automated email from the ASF dual-hosted git repository.
epugh pushed a commit to branch branch_9x
in repository https://gitbox.apache.org/repos/asf/solr.git
The following commit(s) were added to refs/heads/branch_9x by this push:
new 3c1f4d25c66 SOLR-17655: Mark ExternalFileField as deprecated (#3257)
3c1f4d25c66 is described below
commit 3c1f4d25c66c8f75dc9daaef8234349cf0b9eed9
Author: Eric Pugh <[email protected]>
AuthorDate: Wed Apr 2 08:41:12 2025 +0200
SOLR-17655: Mark ExternalFileField as deprecated (#3257)
* Mark ExternalFileField as deprecated
* point to the replacement
---
solr/core/src/java/org/apache/solr/schema/ExternalFileField.java | 2 ++
.../modules/indexing-guide/pages/external-files-processes.adoc | 7 +++++++
.../indexing-guide/pages/field-types-included-with-solr.adoc | 2 ++
3 files changed, 11 insertions(+)
diff --git a/solr/core/src/java/org/apache/solr/schema/ExternalFileField.java
b/solr/core/src/java/org/apache/solr/schema/ExternalFileField.java
index 2baa7e22781..5084eabf9da 100644
--- a/solr/core/src/java/org/apache/solr/schema/ExternalFileField.java
+++ b/solr/core/src/java/org/apache/solr/schema/ExternalFileField.java
@@ -65,7 +65,9 @@ import org.apache.solr.uninverting.UninvertingReader.Type;
* fl=id,field(inventory_count)</code>.
*
* @see ExternalFileFieldReloader
+ * @deprecated ExternalFileField is an old capability of Solr that pre-dated
in-place partial updates of numeric DocValue fields.
*/
+@Deprecated(since = "9.9")
public class ExternalFileField extends FieldType implements SchemaAware {
private String keyFieldName;
private IndexSchema schema;
diff --git
a/solr/solr-ref-guide/modules/indexing-guide/pages/external-files-processes.adoc
b/solr/solr-ref-guide/modules/indexing-guide/pages/external-files-processes.adoc
index 9d8ef590413..196a4bd3d07 100644
---
a/solr/solr-ref-guide/modules/indexing-guide/pages/external-files-processes.adoc
+++
b/solr/solr-ref-guide/modules/indexing-guide/pages/external-files-processes.adoc
@@ -21,6 +21,13 @@ It can also consume a stream of tokens that have already
undergone analysis with
== The ExternalFileField Type
+.ExternalFileField has been Deprecated
+[WARNING]
+====
+ExternalFileField has been deprecated and will be removed in a future release.
+Please use xref:partial-document-updates.adoc#in-place-updates[in-place
updates] for numeric fields.
+====
+
The `ExternalFileField` type makes it possible to specify the values for a
field in a file outside the Solr index.
For such a field, the file contains mappings from a key field to the field
value.
Another way to think of this is that, instead of specifying the field in
documents as they are indexed, Solr finds values for this field in the external
file.
diff --git
a/solr/solr-ref-guide/modules/indexing-guide/pages/field-types-included-with-solr.adoc
b/solr/solr-ref-guide/modules/indexing-guide/pages/field-types-included-with-solr.adoc
index 81c0601fb6e..ede6ade2961 100644
---
a/solr/solr-ref-guide/modules/indexing-guide/pages/field-types-included-with-solr.adoc
+++
b/solr/solr-ref-guide/modules/indexing-guide/pages/field-types-included-with-solr.adoc
@@ -99,6 +99,8 @@ This shortcoming may be addressed in a future release.
|EnumField |Use EnumFieldType instead.
+|ExternalFileField | This field is deprecated and will be removed in Solr 10.
+
|TrieDateField |Use DatePointField instead.
|TrieDoubleField |Use DoublePointField instead.
